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0* Notation Used in this Manual 

_ 

0.1 Numbers 

All numbers written la arable numerals are octal except as follow i (1) 
those part of a naae, such as a type *35" teletype, (z) those part of the 
■eta-* true % ure of this manual {a page or section number for exaaple), (3) or 
those that are floating point, which will always have more than one digit to 
the right of the decimal point. Numbers that are written alphabetically are 
decimal. 

0,2 Character Objects and Strings 

Character objects and strings are usually surrounded by quotation mar*s 
(" *) and are relatively clear from context P Son-graphic characters created by 
holding down the control shift of a teletype and striking a graphic are 
represented by the graphic preceeded by a "*"' as in ~A for *control-A"* 

0,3 Bit Positions and Intervals 

Bit positions la thirty-six bit words are represented by the concatenation 
of a digit from ^through 4, a "." ( and a digit from I through 9* The first 
digit is a quadrant number starting from the right or least arithmetically 
significant part of the word. The second disit Is a bit number in the 
quadrant, also starting froi the right or least significant bit. Thus 1-1 is 
the lowest bit and 4.9 the sign bit. 
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Bit Intervale are represented by the concatenation of an included starting 
bit position* a - a and an included terminating position* Thus 3.3-3,1 is the 
lowest octal digit in the left half of a word, 

0*4 Internal References 

Most internal references in the text of this manual are of the following 
form: [App x] p [Hef x], and [Sec %\ m These refer, respectively, to the x' th 
appendix, the x'th itei In the section of this aanual entitled "References" p 
and the x'th numbered section of this manual. Other internal references are 
written out in la$$ formality and forms whose meaning should be evident* such 
as the following, are allowed: [Sec x p j], [App x; 3ef x B y] „ etc* 









■ 
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li Introduction to and Goals of ITS 

The Incompatible Tlae Sharing system (ITS) ts a control program tailored 
to the Project MAC Artificial Intelligence UI) Group PDF^-5 Installation* It 
was designed in an attempt to provide the following potential advantages of a 

tine sharing system: 



(1) More than one person can perform tasics not requiring all available computer 
resources with sealing simultaneity; one person can similarly perform several 

tftftot« 

(Z) Each user has better control over hardware and greater ease In debugging 
software due to appropriate designed-in features* 

(3) Jobs which would otherwise require excessive blocks of tine can be 
perfoned automatically In srall parts over long periods of time when the 

computer would otherwise be Idle, 

(4) Programs can aore easily be made independent of specific input and output 

devices. 



It was desired to achieve these goals without the usual penalties of time 
sharing systems such as rancid response and ussive inefficiency and their 
attendant evils such as required breafc characters, arbitrary built in command 
levels of dubious virtue „ and severe core restrictions due to a bloated 
monitor. 

Tor these and other reasons ITS was designed with the following 
properties; 






■ 
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(1) ITS sita In control of the PDP-6 perforatum lost input-output for end 

allocating machine resources among various user programs. 

(2) All user programs reside in core storage so It Is possible to switch 
between programs with great rapidity and have sufficiently short quanta to 
allow character response without undue Inefficiency. (The coming Installation 
of additional disk storage will enable the swapping of programs but It Is 
expected that only dormant programs will be swapped out.) 

(3) ITS has only a minimal direct user command facility to assure users that 
they can maintain control over their progxaas. Almost all system actions are 
the result of systems calls executed by the user's programs. 

(4) ITS attempts to provide staple standardized Input-output and other system 
calls as well as more complex and specialized calls which reduce overhead or 
enable the use of special devices and features. 



MIDAS, a machine language assembler with macro facilities [Sef 3, 10], was 
chosen for writing ITS because of the resultant efficiency, flexibility, ease 
in writing, and ease In debugging* Tor information beyond or more recent than 
this aanual consult the sources listed in Appendix D. 

1.1 Preview of Section Z 

The user of ITS noraally comaaads a hierarchy of programs in machine 
storage organized in an Inverted tree. The top procedure is initially loaded 
for hi* by the system when he types a Z on an idle console. All programs may 
have inferior procedures which they control. Almost all commands to the system 
are machine instructions [App A; Ref l], which trap to the monitor, executed 
for the user by his programs. The only exception is that he may interrupt the 
superior procedure of the program with which he is conversing by typing ~"2. By 
this aethod the user can return to his top procedure at which point ~Z*s typed 
on hie console are ignored by the syatea. 
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1*£ Previa* of Sections 3 and 4 

The majority of the code for the ITS monitor is devoted to input-output. 
It has been organized with such goals tn mind as flexibility, speed, and 
genera llty* Simple device independent system calls are available where 
meaningful, and a continuum to the specialized system calls necessary to sake 
nearly fall use of some specialized devices exists. Most lei ices are 
referenced symbolically [App B] and procedures may cause symbolic translations 
such that an inferior procedure referencing a particular device will in fact 
?at a different device. Input-output *ay be done a character or word per 
system call or, for less overhead per character or word, an arbitrary size 
bloc* of words may be transfer ed into or out of the user program's core with 
one system call. The user program is not required to have any buffers in Its 
core ta&ge* Many special features relate to consoles or special devices on the 
PDP-6 such as ayes, arms or the DEC 340 display* 

1,3 Preview of Section 5 



A feature of the ITS monitor not frequently found in time sharing systems 
and contributing greatly to its flexibility and generality is that user 
programs may receive software implemented interrupts in much the same way that 
ITS receives hardware interrupts* The system is so designed that the user is 
rarely involuntarily unlnterruptahle for more than a few hundred microseconds. 
If the interrupt is dismissed in a normal manner the non-interrupt portion of 

the program can proceed even from the "middle* of a system call tafcing an 

■ 

arbitrary amount of time. 
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A scheduling algorithm is used which tries primarily to equalize machine 
time used by each active procedure tree (console) and secondarily to equalize 
machine time aaong those procedures In each tree. The system variables related 
to a particular procedure [App C] used by the scheduler and other parts of ITS 
are leapt in system memory and do not impinge on the user's core image. 

1.4 Preview of Section 6 



User programs operating within the environment provided by ITS are 
organiied (*s mentioned in 1.2) as inverted tree hierarchies, Superior 
procedures can retrieve and store words in their inferior procedures as if they 
were input-output devices. There also exists a large set of special system 
calls for controlling procedures immediately beneath the* and several special 
ways that procedures may communicate with their superior procedure. Buffered 
communication betweea arbitrary pairs of procedures treating each other as 
input-output devices is also provided. 

1.5 Preview of Section 7 

r 

A large nuibsr of miscellaneous system calls and features exist for a 
variety of purposes. Many provide easy Inpit-output to devices which do not 
fit the fores of~standard ITS devices. Others provide the use of certain 
hardware aodif ications to ths PDP-6 which enable the simulation of certain 
features of aanoal control of the PDP-6. such as address stop* The remainder 
are such minor but necessary functions as login and logout. 

A special procedure, known as the system Job, exits under ITS. It 
performs various low priority functions for the system and checfes constant 
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portion* of ITS against a copy in an attempt to detect some form* of system or 
hardware failure. 
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2 t Gettias the Attention of and Transmitting Commands to ITS 



2.1 Control Z 

The only itea of Uput-ontput data recognised by ITS directly as a command 
is the character ~Z then received froai an Idle teletype (a matter of the class 
of devices that may be consoles, currently either a GE terminal or a KSR 35/37) 
or from an active console, that is a teletype In control of a procedure tree* 
Teletype* may also be in use as ordinary devices (as Tm instead of TTT [Sec 
4.5]) In which case ITS ignores """Z's typed on them. 

If the teletype was idle, Z normally causes the teletype to bscome a 
console and leads and starts as Its top level procedure [Sec 6,1] the dump file 
naaed * HACTRN on device STS, or If aot found there from device UT2 (see 
section 3*1 for a discussion of file and device names). The JKAMB of a thus 
initiated procedure is HTH and its [WANE and SHAME are set to the value minus 
one [Sec 3.8.4. 6.1]. This will not happen if there is insufficient memory 
available, if the systea is icaona to b* going down soon [Sec 7.5.2], or if too 
maay people type ~Z simultaneously. ITS will echo a "z tyoed on an idle 
teletype if and only if it succeeded in starting a top procedure. 

The effect of ~Z In the second case, that of an active console, is 
intended to be such that the user at the console may cause control of his 
console to revert" 1 to higher level procedures and ultliatly to his top level 
procedure even in the face of hostile inferiors. 

A ~Z typed on an active console ia ignored by ITS if the console is being 
controlled by its top level procedure. Otherwise it sets a flag associated 
tfith the console so that It may not be assigned downward in the procedure tree 
[Sec 4.5*1] . This fla? ia cleared only by typing any character other than *Z 
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on the console* ITS also sets the **Z interrupt bit, a class one Interrupt [Sec 
5.2] t for the procedure controlling the console and possibly for an arbitrary 
nuaber of procedures, each the ioaediate superior of the last, extending upward 
in the tree from the procedure controlling the console. The condition for each 
step upward In the procedure tree Is that either the superior to the procedure 
currently haying its ~Z Interrupt hit set Is stopped or the current procedure 
was found to already have its ~Z bit on* 

Actio* on *Z Interrupt bite [Sec 5,2] set will be tafcen In less than one 
quantum time when the scheduler [Sec 6,5] next runs, 

2.2 Trapping Instructions 

Mith the exception of *2 all coaaanda to ITS are given by Instructions 
which trap to the aonitor. All valid coaaands are from a class of Instructions 
called 0OO*9 which are characterized by an initial octal digit of 0- These are 
discussed In section 2,2.1 and listed In appendix A. Section 2.2.2 concerns all 
other trapping instructions. It is a useful characteristic of the PDP-6 that 
an identical effective address calculation Is performed on all words fetched as 
instructions regardless of their operation code or legality [Ref l] * Thus 
indexing and indirect addressing are available on all trapping Instructions. 
Interrupts to the monitor as a result of conditions encountered in the 
execution of an Instruction (such as memory protection violation, A3 overflow, 
PDL overflow, etc) rather than the type of Instruction are mentioned In section 
5.2. 
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2.2.1 UUO'S 

The execution as Instructions of words with an oT&rattsa cola [Ref l] of 
from 000 to 077 normallj results in the instruction word toeing stored In 
absolute location 40 modified by having had its effective address computed and 
stored In its address field and Its indirect and index fields cleared* The 
instruction in absolute location 41 Is then executed. Since all ITS system 
calls utiliie only UffO's 040 through 047 the Project MAC AI Group's PDP-6 has 
been modified so that TOD's 001 through 037 and 050 through 077 will trap, as 
described above* directly to the user program's relocated core iiiage with no 
extra overhead. UUO 000 will also appear to trap to the user but this occurs 
via monitor simulation that checfcs to see if relocated location 41 directly 
addresses (indexing or indirect addressing i snored) a location between 20 and 6 
less than the top of the user's core image inclusive. If so, & JSR to that 
location is simulated* If not, the user's illegal instruction interrupt bit, a 
class two Interrupt [Sec 5.2] f is turned on, 

A complete list of system calls in nunerle order appears In appendix A, 
However a list classified by operation code is included here; 



DUO Symbol Description 

040 .IOT Executed for each item or block of data transmitted 
between a user program and a symbolic input-output device [Sec 3.3] . 

041 ,QPB( Used to initialize input-output between a device and a 
program [Sec 3,2] s 

042 ,QP2H A class of syatea calls further decoded by the value of 
their effective address* 

043 .CALL A class of systei calls further decoded by the value of 
toelr accumulator field, 

044 ,USEr Executed by procedures to exaaine and set some of the 
system variables associated with their inferior procedures [Sec 6,2,3]. 

045 *m2t& Executed by * procedure to set the procedure's .BREAK 
Interrupt bit, a class one interrupt [Sec 5.2] thus stopping Lt and 
interrupting its superior porcedure [Sec 6,3,2], 
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CMS .STATUS Used to ascertain the status of an input-output ieTlce, 

channel , or transfer [Sec 3,5], 

04? .ACCSSS CJsei In Input-output to randoaly addressable devices [Sec 
3.3.5]. 



ITS systaa calls ware designed to be numerically rather than symbolically 

decoded to decrease thslr buliciness and ouiDbersomness and increase monitor 
efficiency. 



2.2.2 Son-JUO Trapping Instructions 

The only other trapping instructions are those whose first octal digit is 
7 and the Instruction JftST with the 10 or 4 bit on in Its accumulator field 
[Ref I]. The first of these two includes all instructions which effect 
hardware Input-output and aost of those affectins the state of the PDP^S 
instruction processor (lacludin.3 'aser/execitizs mode}* In the second the 10 
and 4 hits respactlrely dismiss a hardware interrupt and stop the ?QP-S. The 
execution of any of these trapping instruction!! causes an illegal instruction 
Interrupt to the usflr (a class two interrupt, see section -3.2). The reaainins 
way to affect the state of the processor is a JRST Instruction with the 2 bit 
on in the accuaulator field; however, in user aoie this will not effect the 
state of the user, special or lot-user [Sac 7.3.3] nodes except that it aay 
turn off lot-user node. 
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3. The General Transaction of Input-Output 



3*1 Philosophy and Organisation 
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• 



Standard ITS Input-output has been organised with such goals as symbolic 
device independence, no required buffering in the user's core image, simple 
unit (character word, vidlsector point, etc J mode transfers available along 
with block at a time transfers which reduce overhead by reducing the number of 
system calls* Each procedure has associated with it 20 Input-output channels 
(but see sections 3*7, and 4.12). Each of these transfers in one direction and 
mode between the prosrai and a file on a device with which the channel was 
associated by the execution of a .OPES [Sec 3*2]. Items are then transmitted 
over the channel by the execution of .IOT's [Sec 3.4]. This association »ay be 
terminated by a .CLOSE [Sec 3,9*1] or anothsr *OPBN o^ the same channel* 

All data transfers directly to or from symbolic ITS devices [App B] 
(except IfID, MTD, and some modes of IMX) ars effected to or from buffers in 
system memory. In the case of major file devices (BTn and DDn) these buffers 
are dynamically allocated from free memory by ITS [Sec 5.3]* The additional 
overhead required to transmit data between a user's core ima«e and the system's 
buffer as compared with a system having direct user core image input-output Is 
negligible in comparison to any sisniflcant processing of the data* fling 
system buffers has the following advantages; 



■ 
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(1) The user may be Interrupted, swapped oat, moved In core, or otherwise 
molested dor Lag an .10T [Sec 3.4] as it is the software transfer of data 
between system buffers and his core* 

(2) Real input-output transfers may proceed without consideration of the elate 
of the user program they are occuring for as they are into or out of systee 
controlled naaory. 

(3) Higher core storage usage efficiency is obtained due to the dynamic nature 
of najor file device buffers. Even for devices with fixed buffers, such as the 
line printer p only one laree buffer need exist regardless of how tany programs 
that could use the device are in the system, 

(4) User programs need not concern themselves with the size of physical blocks 
on devices. 



Some devices do not fit this framework very well and system calls relating 
to theffl are Included in section ?. Miscellaneous calls related to particular 

symbolic devices are, however, included under the device in section 4, 

■ 

3*2 The .OPES UUQ 

Input-Oiitput on a particular channel is Initialized by executing a ,OFE!L 
The channel is nuaerically specified by the accumulator field of the .QP£« and 
any previous transfer of that chancel is terminated as if by a .CLOSE [Sec 
3,8,1]* If the user is interrupted [Sec 5.2] during a .Ofe$ the channel «ay 
have been closed and not yet reopened. The effective address of the .OPEN 
should point to the first word of a block of three words in the user's core 
Image which specify a device, mode, and file. The second two words specify the 
two file names. As a convention, the file names are usually thought of as up 

to six, left justified, sixbit characters rather than thirty-six bit 

- 

quantities. Zero file naaes are not allowed on many dertces and attempts to 
use them will cause the .OPES to fail. The first word has the three character 
device name in its right half and the direction and aode In its left. 
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Immedlatly below are the standard mode bits from this left half. 



Bit(s) Meaning 

4*9 l=>D*lete or renaie [Sec 3.5] rest of bite ignored* 

0->Open * 
4 # &-3,4 Device dependent. 
3,3 l=**Imase mode. 

0*»A5CXI Bode* 
3.2 l=>Blocic mode* 

0=>tfnlt node. 
3*1 l=*Output. 

Q-> Input* 



The ddTice and file specified will be altered by entries in the translation 
table [Sec 3*3] made by either the procedure or any of Us superior procedures* 
Because of this translation and the synbolic nature of *0PE)l* it la one of the 
slower ITS system calls. 

If the .OPES is successful it will sfclp the Immediately following 
Instruction* If not successful it will not skip and the reason for the failure 
may be ascertained with a .STATJS [Sec 3*6]* knt .OPES closes previously opened 
devices on that channel whether or not the .OPES is successful. 

Piles nay be deleted and renamed with a Mttl but this is usually done 
with a *TDEL2 as explained in section 3*5* 

3,2*1 Pile Directories 

For devices *ith true file structure (tfTn, DDn, CUJ, CIO, COM, and SYS), a 
file directory of the device may be read by tryifl* to input the file ".FILE. 
(Dia)". If character mode is used, a readable file directory terminated by a 
*L and *C results while lma*e mode yields an actual binary of the directory 
uhlch is device dependent. Both block and an It modes are available. Tor other 
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devices character Input of this file name will yield the string "SOK-DIRECTORT 
DEVICE* 1 * AUeapted binary input will fail {the .OPM will not skip)* 

In an ITS produced readable file directory, an "* n by a file name 
indicates that the file is iaaccessable. This aay be due to the fact that it 
is just then being written or it may bare been deleted while open for reading 
and will vanish when closed. An "V by a file naae indicates that it relates 
to a person at that time lodged In. 



3.3 The Translation Table 



Entries in the translation table may be nade or deleted by any procedure 
and have effect only at .OPEH tUe for the procedure making the entry and its 
inferiors. The entry consists of the following: (1) the OSAHE and JHAKE of 
the procedure rating the entry, (2) the JfUME of the procedure It Is to apply 
to (**" aeans all JSAHE's), (3) whether it is to apply to input, output, or 
both, (4) whether its resultant is to be considered final or be retranslated, 
and (5) the froji and to device and pair of file naaes, where * t in froa 
positions match any device or file name and "*"s in to positions indicate no 
substitution. 

At .OPEN tiae ail entries in the table are examined to see if the device 
and file names of the .OPES and the UXAKB and JttAME of the procedure executing 
the .OPES aatch tflea. If so and the procedure which made the entry Is the sane 
or superior to the procedure executing the ,OPE:( a the substitution for device 
and file naaas specified by the entry is made and unless prohibited by the 
entry this process is repeated. Should eight successful and sequential 
translations be aade the ♦OPES will fail and no further attempt will be made to 
translate. 



• 
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3.3.1 The .TRAHS UUO 

■ 

this system call (.CALL 2.) is expectel to point to a three word block 1ft 
the sane manner as a .OPES [Sec 3.2]. It normally skips and returns with the 
block replaced by 1U translation (the block pointed to by a .OPES is never 
changed by the execution of the .OPS;!)* If too many levels of translation are 
required it wLll not skip and the block will be unchanged, 

3.3.2 The .TRAMD QUO 

This system call (.CALL 3,} makes new entries in the translation tibia. 
It ls assumed to point at an el«ht word block as follows; 

IMAMS jmust be the UKAMS of procedure making and subject to entry 
JHANI ;JKAME for procedure subject to entry 
ATMI0..D3U J4.9 = ** retranslate. 1 ■* atomic 

;3.2 * 1 ■» output, 3.1 = 1 =* input 

jOEVl = from device 
mi itroa file names 
FK12 

.,DE¥2 jto device 
FS21 ; to file names 
?H22 






Before trying to insert a new entry in the translation table, this system call 
simulates a .TRMDL pointing at the same block. If a .TRAHAD is successful in 
creating an entry it skips. 

■ 
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3.3.3 The .TRUDl OUO 

This system call (+CALL ?*) deletes entries in the translation table and 
normally points at an eitfit word block identical to the one which was used by 
the corresponding ,tRAJIAD, It skips if successful in deleting an entry* It 
also has a special fori where the first word of the block is aero (not a 
possible UNAME), In this case all entries previously made by the procedure 
doing the .TRHDL relating to the JHAME in the second word of the block are 
deleted* This special font always skips and does not examine the retaining six 
words of the block. 

3.4 The jot uao 

All actual data transfers to or from devices being handled via 
Input-output channels are initiated by ,IOT*s. The accumulator field of a *I0T 
should contain the muibsr of an input-output channel that has been set up for 
transfer In a particular mode between the procedure and a particular device by 
a successful ,0P£S [Sec 3.2]. If the channel has not been .QPEH'ed the 
procedure will receive aa input-output channel error interrupt (a class two 
Interrupt [See 5 r 2]), The effective address of a ,IQT is ua&i somewhat 
differently depending on whether the channel is open in unit or block mode. 

Tor unit nodfl the effective address points to a word to be written froa or 
into* For character unit modes the character is right Justified and the rest 
of the word is ignored on output and zeroed (except as mentioned in section 
3.4.1) on input. Some devices, which are classified as input, use the contents 
of the effective address as an argument to determine what they win store back 
(see devices 1U, VID, and N7D). 
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Block lodes always read or write a contiguous Mock: of word** The 
contents of the effective address of the *IOT is Interpreted as having minus 
the length of the bloc* in its Left half nod the addresa of the first vord In 
its right half. Bloc* mode normally treats each vord in the block identically 
to the corresponding unit mode except that block character nodes pack fire 
characters of seven bits per word left adjusted. The block pointer word 
pointed to by the •IOT is advanced as the transfer progresses so that if It 
completes the left half will be zero and toe right half vlii point to one 
greater than the last word processed. If a procedure is interrupted out of a 
bloc* mode .IOT the pointer word will reflect the progress of the transfer when 
it was interrupted. 

Block character input-output froi soie derlces (namely Tna, TTY t COD, LPT* 
FTP, PLT, and PTR) vhlch are naturally one character at a time is limited to 
blocks of length 77777 words or less and the top three bits of the pointer word 
are used daring the transfer as a character count. 

When a .IOT returns to the user without causing an input-output channel 
error, the transfer it requested will have been completed for unit node input 
or output or block node output* for block mode input, the count in the pointer 
word will indicate the amount trans fered which may be less than that requested 
if an end of file is reached [Sec 3.4.1]. 

3.4,1 The End of file Condition 

for device a on which the end of file vnile reading condition is meaningful 
it is signaled to the uaer in various way* depending on the transfer aode. For 
character devices in the character at a time aode a ~C will be read with the 
left half of the word read into set to ilna 9 one. In block character mode the 
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last word will be filled out with ~C r s, Usually the pointer word will not have 
counted out as the end of file did not occur on a block boundary* For word 
devices, the user nust normally determine the logical end of file from the data 
being read although physical end of file Is detectable In block node by the 
lack of advancement of the pointer word* On soae devices, attempts to read 
beyond an end of file will cause the Input-output channel to be automatically 
•CLOSE'ed [Sec 3.S.1] and further AOT% win cause input-output channel error* 
(class two interrupts [Sec 5,2])* 

¥hen packed characters are hein? real froa a word device the physical 
hlock is normally filled out with ~C*s but soae older files on DEC tape [Sec 
4*1] are filled out with the character whose ASCII value Is 141 (V), The end 
of file character for a particular file can he determined after the file has 
been opened by putting the number of the input-output channel It Is open on in 
the accumulator specified by an ,E0FC >JJO LOPBR 50). This channel numbar will 
be replaced with the end of file character for that channel by the execution of 
the •SDFC. 

- 
3.4.2 The Device Ml Conditio a 

Attempted output on a full file structured device (UTn # DDn) results In an 
input-output channel error (a class two interrupt [Sec 5.2]) for the outputlng 
procedure* This Interrupt will occur for the JOT that failed in auch a way 
that it may be successfully resumed If the procedures interrupt routine or some 
other procedure deletes material froa the full device. 
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3.5 The .FDELE tWO 

The systei call ,FDELE (,CALL 11,) 1$ used for deleting aai renaming 
files. It points at a fire word block which for the three types of .FDGLS's. 

contain the following* 



jfile delete 

-,,DET ;device on tfhlch to find file 
Tm joaies of file to he deleted 

FH2 

jzero 

S on examined 



jnoraal file rename 

- t ,DBi ;dsvice on uhich to find file 

FRti iold file duos 

mz 

TQl ;new file names 
FN22 



jreuaae of file *hile open for ¥rttins 
{unexamined 
jiero 

CHHJH schaanel on which open 
m ;aew file names 

m 



A .FDELE Is internally treated as a .0P2?I pointing at a "block with the 9i$n hit 
on *q the fir it tford [Sac 3*2] except that it loefl not also result Iq a .CLOSE 
helas executed on a channel. A .7DEL8 on a device that is not truly file 

structured has no effect hut skips as io all successful effective .FDELE's* If 

a .FDSLE does not a-lclp the reason for Us failure aajr be detenined with a 

■ 



•STATUS on channel zero [Sec 3*6]* 
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3.6 The •STATUS MJO 



The accumulator field of this system call Is the nuaber of an input-output 
channel whose status word replaces the contents of the effective address of the 
000» This status word is described In detail by the tables below howeTer its 
general composition is as follows: the left half relates to the channel and la 
set by failing .OPSH's, fallins *FD£L£*s and iaput-output channel errors; the 
right half relates to the device, if any, own on the chanel and the state of 
the transfer between it and the user* 



Blt(s) Meaning 

1*1-1.5 ITS physical device code (see table below). 
I. 7-1,9 Mode la which device was opened. 
ZA i » buffer ia^ capacity eapty P 

2.2 1 »> buffering capacity full, 

2.3-2.9 Derlce dependent. 

3*1-3,5 Set by failing .OPEtt's and .FDElE'a (see table below), 
3.7-3,3 Set by Interpreted display [Sec 4,11] Input-output channel errors 
(see table below). 

4.1-4,5 Set by non-dlspliy input-output channel errors (see table below). 
4.5-4.3 Zero. 



The folowlns is a table of ITS device codes (note that the 40 bit Indicates 
that the file names used are significant and the 20 bit Indicates a software 
device)? 



Symbol Device 

Teletype (XSR 35/37). 
Gfi display and keyboard- 
Line printer. m 

Old yilisactor { JfTBj. 
Hew Tldisector { TTC ). 
Calcoiaj) plotter* 
Paper tape pinch » 
Input multiplexor (A-D). 



ZQie 


Symi 


1 


Taa 


2 


Ton 


3 


LPT 


4 


VI D 


5 


OT3 


S 


PLT 


7 


PTP 


10 


IHX 



11 


OHX 


12 


PTR 


13 


MS 


14 


IDS 


15 


COD 


21 


cl 


41 


JTn 


42 


Jl'lL 


60 


OSR 


61 


usa 


62 


cu 


63 


CLO 


54 


— 
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Outpit nultlpletor (D-A)- 

Paper tape reader* 

Dfic 340 display. 

Interpreted display. 

Horse code transmitter* 

Hull device. 

DEC tape* 

Data-disk. 

A dot lued Lately inferior procedure. 

An inferior procedure. 

Cora Utile use device* 

Core link open device. 

The directory device [Sec 3.2*1]* 



The following is a list of the code* left by failing ,QPEif s and ,FD£LB's: 



Cole Reason 

1 Tto such device* 

2 Wrong direction* 

3 Too many translations* 

trile not found* 
Directory full. 

6 Device full, 

7 Device not ready* 

10 Device not available, 

11 Illegal file name. 
13 rtode not available* 

13 Pile already exists (attempted renaae). 

14 Bad channel number (attempted open renaae). 



The following are the error codes left by the 340 interpretive display 
routines; 



Code Meaning 

1 Illegal scope node. 

2 Scope hung, 

3 More than 2030 words scope buffer* 

4 Memory protection violation* 

5 illegal scope operation* 

ft Memory protection violation on PDL pointer. 

7 Illegal parameter set. 
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The following are the non-display Input-out pat channel error codes; 



Code rteanlae 

4 flon-exlstant sub-device {such as IMX channel [Sec 4,9]), 

5 Over .I0POP [Sec 3.7,3], 

6 Over .IOPUSH [Sac 3,7.2], 

7 Channel does not have a procedure open on it. 
3 Channel not open, 

9 net Ice full. 



3*7 The Input-Output Channel Push Down Facility 

For greater flexibility in input-output than that available with the basic 
input-output channel system [Sac 3,1], a facility is provided whereby a Halted 
nuaber of input-ouput transactions nay be stored for later resuaption. 
Meanwhile the channel they were being effected on nay to otherwise utilised. 

3,7.1 The , IOPUSH and -I0P0P 'JUO's 



These instructions treat input-output channels as the PUSH and POP 
instructions [ftef 1] do memory locations. A channel may be * IOPUSH ed 
regardless of whether It Is open or not and any transfer In progress on it will 
be inaccessable until the slot occupied by the information pushed is .lOPOP'ed 
into a channel (possibly different). The error status and .ACCESS [Sec 3,8,5] 
pointer for a chainel are also correctly stored and restored. Executing a 
,IOPOP into a channel first closes the channel. Bach procedure's input-output 
channel push down list [App C] has apace for eight entries. 
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3.7.2 The .IOPDL WO 

This -ay a ten call ( v OP£R 57) is intended to reset & procedures input-output 
channel push down list. Entries on a procedure's input-output channel push 
doom list actually contain the nuther of the channel that was pushed to produce 
the entry. This information is used only tar .IQPDL whose execution is 
wuiralent to the number of .IQPOP's [Sec 3*7*1] equal to the nuaber of entries 
in the procedure's iaput-output push down list and which .IOPOP each entjf back 
into the channel from which it was .IOPOSS'ed* 

3.Q Miscellaneous Uniform Input-Output Related System Calls 

The folowin* syste* calls relate to most or all devices handled via 

Input-output channels. 

3,3a The .GLOSS UOO 

This system call (.OPBfl 7) closes the Input-output channel whose nuaher is 
in its accumulator field* Executing a ,IOT on the channel without reopening it 
will result in an input-output channel error. For devices with true file 
structure it is at close time that a file with the same name as one being 
written is deleted. 
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3.3.2 THe .RESST flUQ 

This system C4ll {.OPER 37) is Ln tended to reset system buffer pointer* so 
that buffered data on an input^output channel (specified by the accumulator 
field) will fce ignored. It has not yet teen kmpleaentai for DEC tape or disk 
transfers and is also isnorad by devices for which it is not meaningful (IHJC, 
0MX t III, and ITO). 

3.8.3 The .IWIC 000 

It H frequently desirable to exaalne the characters of an incoftin* stream 
at the interrupt [Sec 5.2] level of a procedure (for *Vut* features, etc.). 
This system call (.OPEH SO) provides the facility to read these characters from 
channels on which devices that will provide appropriate interrupts (TTY, Tim, 
CLU, CLO) are open. The accumulator reffered to by an .tTTlC should hate an 
appropriate channel nuaber placed in it. The execution of ao .ITfK will then 
replace this nuaber with the character read and atip. If no character is 
available the ATIIO will not stelp aad if an iaproper channel is specified the 
procedure will receive an illegal instruction interrupt. 

5.8.4 The .WSHAMB JUO 

On some devices (namely DDn, CLO and CUJ) files are actually identified by 
three file names. Two of these are STvsclflea in the normal way [Sec 3.2] and 

the third is derivad from the current systen naie [App C] associated with the 
procedure referencing the file. If the file is being written this will b* 
written as its third file name and if beia? real it must be the same as the 
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third file aaie. Each procedure* s systea name is set to the UNAHE of the 
superior procedure that creates it at the time of its creation [Sec 6.1+1]* 
•WSUAME {*0PE£ 35) sets a procedure's current systen naae fron the accumulator 
specified except that if that accumulator contains zero the procedure's SNAME 
Kill be unchanged* A procedure Bay read its SHAME with a ,SUS£T [Sec 6,5]. 

3.8.5 The JLCCKS5 DUO 

This syateo call Is intended to he used in accessing randoaly addressable 
derices. A pointer is associated with euch input-output channel which is set 
to the effective address of a .ACCiiSS executed with the channel's nuafcer in its 
accottuUtor field. Currently this pointer influences only the USft derice [Sec 
4.13]. 



i 
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4. Properties of Particular Devices 

Properties and system calls related to particular devices handled via 
input-output channels are discussed below* Lower case letters in a device name 
indicate that there are several devices distinguished by numeric digits in 
their place. The phrase "all standard modes* in descriptions below Implies 
that all combinations of ASCII/Uage, unit/block* and input/output modes are 
available and that ASCII made iaplles seven bit ASCII characters and iaage aode 
thirty-six Mt binary words* 

4*1 The UTn Devices 






The devices 0TI, UT2, UT3 and CTT4 represent the four DEC tape drives on 
the PDF-6* They are true file structured devices under ITS with all standard 
nodes available. Data is dynamically buffered by ITS for both input and 
output. The file directory of a tape is read in by the system and retained 
when a drive is referenced and there is no directory being retained for It* An 
updated directory will be written out on a particular tape whenever the 
directory has been changed, no files are open on the tape, and no data 
transfers are in progress on any drive. Files on UTn do not have a system name 
[Sec 3*8.4] associated with them* Directories can be excised from core only by 
the JJMSMT MO, m 
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4.14 The .BDISMT UUQ 



This system call {.OPER 22} p if successful, cause* a DB3 tape's fiie 
directory to to excised from core and the tape to be physically dft&ouatftd. The 
4rl?e nuaber *ust be La the accumulator specified by the UDQ. Manually 
reaovlus tapes or switching drive numbers of drifts for which ITS Le retaining 
a directory nay result la out of date file directories left on tapss and 
directories for one tape beins written on another. 

A .UBISHT sfcips if and only if successful. It will fail if aay files are 
open oa the tape. If a file Is opened, deleted, or renamed on a tape while the 
tapa li bains dxsMOuated by ITS th* dtssouat will be aborted and the tape 
retained. 

4.1,2 The .ASS ISM and .MS KM UOO's 

These systea calls are to enable a user to protect against other users 
accidentia referencing his DEC tape to write or delete a file. Both specify 
the dri*e nua tiers as the contents of their specified accumulators. The .ASS1GH 
UUO skips if successful and results in attempts to write on the designated 
driTs failing unless the writing procedure has the same system name [Sec 3.8.4] 
as the UHAME of the procedure that executed the .ASSIGN. Tor a procedure in a 
disowned tree [See 6.2.a] , a ,ASSIM will be treated as an illegal instruction, 
A .aSSIGft will fail only if the drive is already assigned. The .DZSItJK OHO 
sJtips If successful and causes the drive to be unassUned, It falls if the 
drive is already unaligned or assigned to a different user. A drive may also 
be .DESISS'el by a .UD1SMT [Sec 4.1.1] and the .ASSI&X'iH of a drive does not 
protect against other users dismounting it. 
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4.1.3 The .UBUT WQ 

This system call (.OPEH 56) is intended for reading noo-HAC foraat [fief 4] 
(such as BBC format) DSC tapes. The contents of the specified accumulator aust 
toe a drive number for which ITS is not retaining a directory. Instead of 
attempting to read in the directory from the tape counted on the specified 
drive, ITS internally aartcs the drive so that this directory may not be changed 
(no writes, deletes, or renames). At this point a successful ,0PES of the tape 
may he executed with any file nAie and all blocks of the tape will he read 
consecutively. Thus the tape may only be referenced to read the file 
containing the entire contents or to .JDISMT [Sec 4.1.1] It. 






4*2 The DDn, SYS, and COH Devices 






The devices D30 and DDi are two Data Disk M-6 disk drives. They are truly 
file structured with system names [Sec 3.3*4] and have all standard nodes. 
Data Is dynamically buffered by ITS [Sec 5.3] for hoth input and output. There 
file directories are read in the first tlae the drives are referenced and are 
written out whenever they have been changed and the disfcs are otherwise Idle. 

The device STS is used for storage of systems programs and is currently 
those files on defice DDO with systet naae STS, Reading or writing device SYS 
causes one to reference DDO as though one's system naaie were momentarily SYS. 
The device COM is used for coanonly used user files. In a aanner stellar to 
device SYS it is DDI with system nana COMMON* 



■ 
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4.3 The CLO and CLU Devices 

these internal devices are usad for buffered interpraceiure communication. 
One procedure oust open % file on device CLO (core link open) and the second 
matt then open a file with the same names (including systei name [Sec 3,3,4] ) t 
mode, and the opposite direction on device ClU (core lint use). Ml standard 
modes are available. For character mode transfers, interrupt level processing 
is available [Sec 3.8.3, 3.2], Each liak has a 200 word buffer associated with 
It. 



4.4 The NOL Device 

This device has all standard nodes and is a bl&h speed Infinite sink oa 
- output and source of zeros on Input. 

4.5 The Tn» and TTT Devices 

Devices TOO through T04 represent teletype lines to the PDP-6 with KSH 
35/3?' s on the other end. Devices T15 through T20 (the two digit* are treated 
as an octal aunber) are GE Datanet 750 terminals with a character only display 
and keyboard, (Devices TOS through T14 may soon be available for more teletype 
and teletype-lite ^hardware.) Device TtfT for a particular procedure ia the 
console coatroling the procedure tree it is in. All input-output to these 
devices is in ASCII characters and the "image* mode [Sec 3,2] has special 
meanings . 

A procedure may not oven its console by refering to it as Tnm for the 
corresponding n and m. Only one procedure at a time may have a teletype open 



-■ 
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as a device rather than a console. The procedure with TOO opened as a console 
(TTT) and that actually has controls of it [Sec 4.5.1] can always seise the DEC 
340 display [Set 4.11]. 

Image node output to KSR 35/37' s is vary straight forward and Just sends 
the character to the teletype un»odlfied, ASCII mole differs only In that the 
character whose value 13 33 is printed as a "$"» other characters with a value 
less than 40 that are not foraat effectors or bell are printed as an 
followed by the character with an ASCII »alue 100 greater, and new line is 
simulated for a carriage return. Output to &S terminals is the saae as ASCII 
mode output to KSR 35/37' s except for the following (l) all line feeds (12) 
are ignored, (2) a ~L (form feed) clears the screen, (3) an automatic new line 
Is inserted if the right margin is touched, (4) a "_"■ as displayed by the SE 
teraioal. Is used Instead of an *"" prefix, (5) output beyond the boUo» of the 
output area *raps around and overwrites from the top of the output area which 
does not include the bottoa three lines unless the first input .OPEH [Sec 3.2] 
had the 3.4 mode bit on, (6) finally, if the output Is in lma*e mode only, the 
Character ~T will allow oTsr writ ting starting from the top of the output area 
without clearing the screen or wrapping off the bottom. For all the abore 
output aodes, adding block mods only affects individual character processing by 
causing Vs that are output to be ignored. 

Input to keyboards (which are all full d-iplat) Is buffered by I K in 
relatively small fixed size buffers. Striking a key whan this input buffer Is 
full results only in a "l {bell J (or V on a SB terminal) being output as 
echo. Any Input when the keyboard is not in use except A Z [Sec 2.1] * Is 
Ignored by ITS. Procedures aay enable Interrupts (class three) due to 
non-empty Input buffers [Sec 5*S] and also exaaiae the Input characters at 
interrupt tiat tfith .ITTIC [Sec 3.8.3] . 
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Image lode Input is character lied by no ITS supplied echo end ao 
modification of the character codes unless open aode [Sec 3.2] hit 3.5 Is also 
on, in which case lower case SSH 37 characters are transformed to upper case 
KSH 35 characters, 

ASCII node input provides echo in approximately the saite manner as 
outputlng the characters la ASCII mode. Procedure output has higher priority 
than echo output. On SE terminals input is normally echoed In the bottom three 
lines unless the 3.4 open aode bit was on. In which case characters are echoed 
where output Is appearing except that a few characters are not echoed at all, , 
In ASCII mode lnput t the characters whose values are 175 and 176 are Input and 
echoed as if they were the character whose value is 33. Having open mode bit 
3.5 on has the same effect for ASCII mode input as it did for Image mode Input. 
In general, all of the various mode bits effecting Input are obtained froa the 
first Input .OPES [Sec 3.S] executed by a procedure for a particular teletype. 
for all the above input aodes, adding block mode results in Input until the 
block input pointer runs out or until a ~C is typed at which point the .IOT 
[Sec 3,4] being executed terminates as on an end or file [Sec 3.4.2] . 

Any input or output .IOT or .OPSi executed on a TTY device while it is 
actually being controlled by another procedure [Sec 4.5.1] will hang until the 
executing procedure regains the device. 

4.5.1 The .ATTY and .DTTY 030* i 

These system calls (.OPGR 11 and .QPSR 12 respectively) enable procedures 
in a single console controlled procedure tree to transfer control of their 
console between each other. The execution of either by a procedure that does 
not have control of the console, because it was taken away by a higher 
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procedure's execution of a M, will hans until it regain* control, the 
accumulator field of each must specify a channel on which an immediate inferior 
procedure is open [Sec 4*12]. An .ATTY will pass control of the console to 
this open procedure unless the procedure executing the .ATTY has control of the 
teletype or taking It from soma deeper inferior along the sa;n* procedure tree 
branch in which case it reverts to the procedure fro* which it came. An .ATTY 
will hang instead of do ins the above If the last character typed on the console 
was a "Z. A .DTTY retrei«s control of the console froi sone Inferior to the 
procedure executing it. 

Both of these calls skip if successful. An .ATTY will fall to skip only 
If no Inferior is open on the channel it specifies. A .DTTY will fail to skip 
if no inferior is open on the channel it specifies or if the procedure 
executing it never had control of the console or nerer gave control away. All 
other conditions blocking the success of either system call cause them to han«. 

4,5.2 The .LlSTiM UUO 

This srstea call (.OPER 2) is usable only on the console a procedure is 
associated with. It will hang If control of the console [Sec 4.5.1] has been 
taken away froa the procedure executing it and If all procedure output has not 
been typed. It then returns with the nunber of buffered input characters in 
the specified accumulator. If the procedure has never had control of the 
console or is In a disowned tree [Sec 6.2,2] sere will be returned. 
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4.6 The LPT Device 

4 Six hundred line per minute Data Products, Inc. line printer with one 
hundred aad twenty print positions and sixty four printing characters is 
available for character output as device tPT. The ASCII iaage mode Mt [Sec 
3.2] is ignored in .OPEH's on device LPT but either single ASCII characters or 
blocks of packed characters may be output as Indicated by the block/unit node 
bit. The foil owing "transformations" are made to the output text; U) lo**r 
case characters are made upper case, (2) characters beyond the one hundred and 
twentieth print post ion are ignored, {3) format effectors (except for vertical 
tab) are simulated as for a model 35 teletype, thus overprinting can be 
accomplished by using carriage return without line feed, (4) characters with an 
ASCII f&lue below 40 other than the simulated format effectors and character 
33, which Is printed as a T, are printed as a 9mm followed by the character 
whose ASCII value is 100 greater. 

Only one procedure may have the LPT device open at one tine but it may be 
open on sore than one channel. A fixed 1000 word buffer in ITS is used for 
output to this device. 



4.? The PLT Device 

A CalCoap model 555 plotter [Ref 9] is available via "character" output to 
device PLT. Available with the sane modal restrictions as the LPT device [Sec 
4.6], it is also similar to that device in that it may only be open by one 
procedure at a time but may be open on more than one channel. A fixed 200 word 
area is used in ITS to buffer output. 
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Only the Tight most sli bits of characters output to the PLT device have 
effect. They are from rUht to left as follows: (1) pen up f (2) pen dovn, (3) 
plus x t (4} minus x # (5) plus y, (5) minus y. 

4.3 The PTP and PT3 Devices 

The PTP and PTft devices represent, respectively, the sixty three and a 
third character per second paper tape punch and four hundred character per 
second photoelectric paper tape reader on the PDP-6 [Ref i]. They are similar 
to the LPT and PLT lit ices [Sec 4.6 P 4*7] in that only one procedure my hare 
each open at one time but that procedure lay have the device open on more than 
one channel possibly in different moles. Also output or input Is buffered in 
ITS in fixed areas of 20 and 10D vords respectively. These deTices differ from 
the LPT and PLT devices In that all standard lodes [Sec 4] are available and 
the following special mode. If in a successful ,OPEH for one of these devices, 
the 3,4 mode bit [Sec 3.2) Is on then the 3,3 mode bit is Ignored, the 3.2 mode 
bit must indicate unit mode, and all eight papar tape channels may be written 
or read from or into the ai^ht rightmost bits of the word addressed by each 
*I0T [Sec 3*4] executed . 

4.9 The Ul Device 

A multiplexed analog to digital converter attached to the PDP-6 is 
available via word input from the IM1C device [Ref 5, 6]* Block and unit modes 
are available but the "ASCI I /image" mode bit [Sec 3*2] has a special 
significance explained below. Each word input into must initially contain a 
number from zero to 17?* This number will be replaced *tth the twelve bit 
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digitalisation of the analo* quantity associated with the multiplex channel of 
the same numl>er. If it is desired to read la values converted at each .IOt 
[Sec 3.i] tine then device IMt should be opened in "iSCIt" mode. Opening 
device IKI in "image" mode causes ITS to continuously read all input 
multiplexor channels into system core a minimum of about ten tiaes a second. 
Executing a .IOT on a channel opened in this manner will result in values up to 
one tenth of a second old but without the overhead necessary to read in new 
values. Any number of procedures may have the 1MX device open, possibly on 
different channels and possibly In different modes. Current I5« channel 
assignments are as follows: 



Channel Input function 



0-42 


Unused, 


33 


STD iris. 


34 


WD focus. 


35 


(TO mirror. 


36 


Rhomboidal last table pot A. 


37 


Rhomboida! test table pot B. 


40 


Rhomboidal teat table pot C. 


41 


Rhomboidal test table pot D. 


42 


Pot bo x upper left. 


43 


Pot box upper right. 


44 


Pot boi lower rl;ht. 


45 


Pot box lower left. 


46 


Hew arm shoulder. 


47 


Sew arm shoulder. 


50 


Sew arm Joint 1A. 


51 


Sew arm Joint IB. 


53 


Sew arm joint 2A. 


53 


Sew arm Joint 2B. 


54 


Dew arm joint 3A. 


55 


Sew in joint 3B. 


56 


Sew arm joint 4A. 


57 


Sew arm Joint 4B. 


60 


TOR output. 


61 


Alies hand tilt. 


62 


Alles hand extend. 


63 


Alles hand rotate. 


64 


Alles hand grasp. 


65 


IMF arm wrist roil. 






■ 
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66 

67-70 

71 

72-73 

74 

75-76 

77 

100-111 

m 

113 

114-137 

140 

141 

142 

143 

144 

145 

146 

147 

150-165 

166 

167 

170 

171 

172 

173 

174 

175 

17S 

177 



pot 
pot 



two. 
three. 



AHF arm wrist yaw, 
AMF arm horizontal high resolution. 
AM? arm horizontal absolute position- 
AMF am awins high resolution* 
AMI artt swing absolute position* 
AMF aria vertical hieh resolution. 
AHF ara vertical absolute position* 
Unused, 
Joy stick X. 
Joy stick Y. 
Unused. 

Hew pot box pot one. 
Sew pot box 
Hew pot box 
Hew pot box pot four. 
New pot box pot five* 
New pot box pot six. 
Hew pot box pot seven. 
Sew pot box pot eight. 
doused. 

Joy stick console 
Joy stick console 
Joy stick console pot eight. 
Joy stick console pot seven. 
Joy stick console pot six, 
Joy stick console pot five. 
Joy stick consols pot four, 
Joy stick console pot three, 
stick console pot 



pot 
pot 



ten. 

nine. 



Joy 



two. 



Joy stick console pot one. 



4.10 The 0MX Device 



i Multiplexed digital to analog converter on the PDP-6 is available via 
word output to the OMX device [fief 5, 6]. Block and unit modes are available 

and the "ASCII/iaage" aiode bit [Sec 3.2] baa a special significance explained 
below* Each word output should have the desired channel number In bits 4.9-4.4 
and the value to be converted in bits 4.3-3,1, Thus channel numbers range fron 
zero to 77 and values from zero to 7777. These output channels decay 
exponentially with soae large time constant so ITS stores the current desired 
value for each channel and outputs then every half second as long as the 0MX 
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device it open by some procedure. Output In "ASCII* mode inaediately effects 
the channel as veil as s tori as a value to he output periodically. Slightly 
lea a overhead occurs la "image" mode which only stores a value In ITS and may 
have no effect for up to half a second. Any number of users may have the OHX 
device open, possibly on nore than one channel and possibly in different modes. 
Current OMX channel assignments are as follows* 



Channel 


Effect 


0-31 


Unused. 


32 


hyd iris. 


33 


HTD fOCUS. 


34 


STD mirror. 


35-53 


Unused. 


54 


Mew arm shoulder. 


55 


Hew arm shoulder. 


53 


New arm Joint 1A. 


57 


Hew arm joint IB. 


60 


Hew arm Joint 2k, 


61 


lew arm Joint SI. 


62 


Hew ara joint 3A, 


53 


Hew arm joint 38, 


64 


flew arm Joint 4A. 


65 


Hew arm Joint 4B. 


SS 


Alles hand *?rlp. 


67 


Alles hand tilt. 


70 


Alles hand extend. 


71 


Alles hand rotate. 


72 


AHf arm wrist roll 


73 


AMP arm wrist yaw. 


74 


TDH horizontal . 


75 


AMP ara horizontal 


76 


AMP ara vertical. 


77 


AMP arm swing. 



4,11 The BIS and IDS Devices 






The DEC 340 display [Ref l] differs significantly from all other device* 
usable in ITS. In order to maintain an image on the display it is necessary to 
repeatedly outpat to it a list of display words. This list auat be stored In 
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main memory and the various *eans of using the dispaly may be divided Into 
those that maintain this list in systea memory (discussed in this section) and 
those that alio* the list to be maintained in the users core image [Sec 

4,11.1]. 

Only one procedure at a time nay use the 340 display and in only one of 

Its three modes (as symbolic device DIS, as symbolic device IDS, or Tia the 
.DSTART and .DSTittX TOO's). If the display is free, any procedure may seize It 
by executing a proper .OPB* on devices MS or IDS or by executing a .DSTART or 
.DSTRTL UUQ. If the display is In use, however, a procedure will succeed In 
any of the above *TJO*s only If it Is the procedure that has the display or It 
has control of device TOO as a console [Sec 4.5], If the second case applies, 
the channels, if any, on which the other procedure had the DIS or IBS open will 
be modified to the corresponding (block or unit) m device [Sec 4.4] output. 
,CL0S3'ln« [Sec 3.8.1] M input-output channel on which device DIS or IDS are 
open is the same as executing a .DCLOSS [Sec 4,11,3], 

The DIS symbolic device allows the user to output single or packed blocks 
of ASCII characters in ASCII mode and single or blocks of 340 display list half 
word3 [Ref l] In image mode. This device may be open on more than one channel 
at a time In po33lbly different modes. If the user outputs characters and then 
half words, ITS will automatically Insert intervening items to cause the display 
to escape to paramerer mode. If the user outputs half words and then 
characters, ITS' assumes that he has Inserted items to cause the display to 
escape to parameter mode, A display list produced by output to the DIS derlce 
will start by setting the 340 display intensity to 7, its x and y coordinates 
to sero and 7000, and its scale to one larger than the 3.4-3.5 field of .OPEN 
mode bits [Sec 3.2] used unless that field Is 3 in which case the scale is set 
to zero. Lines of character output that extend beyond the right edge of the 
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screen will wrap around and continue from the left. Lines of character output 
that extend Beyond the bottom of the screen similarly continue fro* the top. 
The amount of display information created by DI5 output nay not exceed 2000 
words, Af ter that, further output Is ignored. The stored information created 
hy output to the DIS device may be deleted to accept new information by 
outputiog a *t or a ~t (form feed) character. In the latter case, this action 
will be delayed for a few seconds. 

The IDS syibolic device allows the user to use a semi-idealized display. 
This device is known as the interpreted display since the user writes 
"instructions'* to be executed by a display processor whtch are then interpreted 
by ITS simulating the processor and creating a 340 display list to actually 
display. , The IDS device say only be opened in unit output node and what the 
user outputs to it is the location, in the user core image, for the display 
processor to start "executing", Almost all error conditions encountered during 
this "execution" cause Interrupts to the nser [Sec 5.3. The sisuiated display 
processor has a push down list facility with Its push down list pointer in the 
user's location 43. The information to he sent by the .lOT'lng [Sec 3,4] of 
each starting location to the IDS device Is normally terminated by over popping 
by the display processor. The information stored by the IDS device is 
currently limited to 2000 words. If the 340 display is being run by the IDS 
deftce when a .I0T Is excuted on it, the display will stop and the stored 

r 

information will b*e over-written. If the 340 display is not being run, output 
from simulation Is appended to that already present. Whether the 340 display 
is started at the end of the simulation Initiated by a .IOT Is determined by a 
display processor parameter that may be set during simulation. 

Instructions for the IDS simulated display processor are thirty-six bit 
words Interpreted a3 five left Justified ASCII characters if bit 1.1 is zero. 
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If bit 1.1 is a one, bits 1.4-1.6 are Interpreted as the following coinandss 



Other fields 



1.4-1.6 Conani 

Q Illegal. 

1 Point, 4.9-3.4 Y t 3.3-1.7 X f 1.2 Intensify. 

2 Rel vector, 4.9-3.4 T, 3.3-1.7 X, 1.2 Intensify. 

3 Increment. 5 left justified S nit fields each: 1.1-1,2 
length, 1.3 Intensify, 1,4-1.6 direction (clockwise froi Tertical). 

4 See below, 1.7-1.9 sttbcoznaand function. 

5 Ab9 vector. 4.9-3,4 T, 3.3-1.7 t, 1,2 intensify. 

6 Illegal* 

7 Illegal, 



1*7-1, 


,9 Function 


Other fields 





Illegal. 




1 


PtfSHJ, 


4.9-3.1 address. 


2 


POP J, 


4.9-3.1 address. 


3 


JUST. 


4.9-3,1 add r 533, 


4 


See below. 


2,3-2,9 parameter to set from 4.9-3,1, 


5 


POSH. 


4.3-3,1 address. 


s 


POP. 


4,9-3.1 address. 


7 


Illegal. 





2.3-2.3 Parameter 

Illegal. 

t Start (node (aomero Beans start after .1QT). 

2 Character scale, 

3 Increment scald. 

4 Tector scale. 

5 All scales* 

6 Coordinate of left ed*9 of displayed area. 

7 Coordinate of bonoa edge of lisplyeJ area. 
10-77 Illegal. 






4.11.1 The .DSTA3T and .DSTiTL CWO's 






- 



These UUO's {.CHI 10 , and .CALL 12. respectively) enable the user to 
display lists that are In bis core iaage. The execution of either attempts to 
seize the 340 display and skips only if successful. 
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A .DSTART shonll point at a location that will always contain either a 
BLiCO [aef 1] type outpat pointer, if one olock of data is to he dlsplayad, or 
the first word of a links! list of display blocks. In this llolcsd list, the 
right half of each entry points to the nsxt entry, or, if aero, indicates the 
end of the list. The left half of each word should he posit ire and is a 
pointer to a BIXO poltitsr or is ignored if it is zero or points to a zero word. 

.DSTRTL differs from .DSTAAT only la that, If it is used to display a list 
of blocks, the left halves of its linked list words are interpreted as pointing 
to the word after not a BUO pointer hat a regular block aode outpat pointer 
[Sec 3,4]. 

4.U.2 The .LTPffl TOO 






The 340 display is equip*! with a light pen that cause: a hardware 
interrupt when tfcfl light in tensity it sees increases suddenly as whet, a spot is 
displayed under it. The display also stops when this occurs and its current 
coordinates can he read in by the PDP-3. The user may enable software 
interrupts (class three) to his procedures when the llsht pen is seen and he 
has the display seUel [Sec 5*2]. 

This syetea call (.CJtLL 14,) enables the user with the display seized to 
read Information about where the light pan has been seen and the state of the 
current transfer to the display* aesults are returned in the contents of the 
effective address and following five locations. The contents of the effective 
address also acts as an arjuaent. If bit 4.3 is zero the rest is ignored. But 
If bit 4,9 is a one then bit 3.1 will causa the .LTPEH to hang until the light 
pen has been seen at least once and bit 1.1 will be used to set the multiple 
sighting aode. If this mode is on, the light pen nay be seen aany tiaes while 



• 
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a display block is displayed once. If this node is off (tero) the lisht pen 
may be seen only once and ignored thereafter for each display of a display 

block* 

The six *ords returned to the user are as follows: (1) the actual word 
DMAI'ed [Ref I] from the 340 display at the tiae of the last light pen 
Interrupt, (2) the nuiber of times the light pen was seen since the last .LPEN. 
(3) the sua of the y coordinates at the points the light pen was seen since the 
last .LPEK. (4) the corresponding sua of t coordinates, (5) the current 1 luted 
list pointer, and (6) the current BLKO pointer* 

4.11.3 The .DCL0S2 UUO 



This system call ( ,0P£a 15) releases the 340 display if executed hy the 
dser who has the display seized, closing any channels on which it is open* 

Otherwise it does nothing. 

4.11.4 The .DSTOP U5JO 

This ays tea call (.OPES 16) stops the 340 display, but does not release 
it. If executed by the user who has the display seized. Otherwise it does 
nothing. It Is Intended for use In conjunction with the .DSTART or .DSTRTt 
DUO. 
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4.12 The USM De*ice 

Tbe USH derlce Actually represents procedures. A successful .OPES [Sec 
3*2] executed on device USH will either create a Dew procedure [Sec 6.1*1] w 
attach a disowned procedure tree [Sec 6.1.2] t or simply associate with the 
Input-output channel on which il was executed aa exi slant procedure. The file 
names are the UUaME and JHAMB of the procedure being .OPEK'ed. Only kaiediate 
Inferiors nay be .OFEfc'ed to write into but any procedure may be examined. If 
an Inferior procedure has been opened, it may be destroyed by a .UCLQSfi [Sec 
6.2.1] but wLU be entirely unaffected by & .CuQSE [Sec 3.7.1] executed on tbe 
channel. The same procedure aay be open on *ore than one channel of its 
superior, possibly in different modes. It la at first .OFEH tine that an 
interrupt bit [Sec 6.1.3] is assigned by ITS to a procedure* The number of 
inferior procedures a procedure may have is currently Halted to eight because 
that is the allowed number of AQiqoe inferior procedure interrupt bits [Sec 
5.2). 

The 3.3 mode bit [Sec 3.2] is ignored in .OFEN's on derlce USE but both 
bloc* and unit aodes are avaiable* Executing .IOT's on channels opened on 
derlce USH results in the transfer of a thirty-six bit binary word or words 
between the procedures. The location in the .GPEK'ed procedure of the first 
word to be traasfered is specified by the .ACCESS [Sec 3.8.5] pointer 
associated with foe Input-output channel on which the transfer Is occuring. 
Each word traasfered adrances the appropriate pointer by one eyen in unit node 
which ITS treats internally as blocks of length one. An attempt to read a word 
beyond the core allocated [Sec 5.3] will result In a class two interrupt [Sec 
5.g] but in a similar attempt to write {possible only for an Immediate 
inferior) ITS will atteapt to extend the procedures core image and an interrupt 



ITS 1.4 Reference Manual page 45 

Mill result only if note core is unobtainable. 

Executing a .RESET [Sec 3,8.2] on a channel with an inferior procedure 
open on it is equivalent to executing a .OCLOSE and then a .OPEN to recreate 
tbe procedure (with reset variables, one 2000 word block of cleared core, etc.) 
but vith leas overhead. 

4.13 The WD and JifB Devices 

These devices are soaewhat similar to the IMX device [Sec 4,9] in that 
tbey aay be open by any nuaber of procedures, bave block and unit nodes, and 
"functional" word input where tbe quantity read is a function of the contents. 
Tiiey differ in tbat tne ASCU/Uage .OPEN mode bit [Sec 3.2] is ignored and 
they represent vidissectors. Tbe initial contents of words input into should 
be the coordinates of a point to tbe field of view of tbe particular 
vidtssector at which it Is desired to know the light intensity. This contents 
will be replaced by a function of said intensity. The exact form of these 
words and the use of any device dependent .OPEK node bits [Sec 3.2] is listed 
in the table below. 

Item fID KVD 

X 2.3-1*1 4.5-3.2 

I 4.3^3*1 2.6-1.2 

value 1.9-1.1 (reciprocal of intensity) 

4.9-3.3 (normalized floating reciprocal intensity) 
£.1-1*1 (integer logarithm reciprocal intensity) 
(too 400 3.1 (overflow) 

dark) 3.2 (dii cut off) 

dead -1 4000000 

modes 3.6-3.4 (340 intensity) 
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3*5-3.4 {confidence level) 
3*&-3*6 {diet cat off level) 



The deflection signals for the ¥Iu device cote fro* the DEC 340 display 
[Sec 4*11] whose use will be degraded by using device ¥11), 

4*14 The COD Devic* 

This is a charcter output device thai may tie used In block or unit *ode 
but not any forfe of image mode and not by aore than one procedure at a tlae. 
It causes transmission of low power IH Morse code at a frequency Just off the 
bottom of the FH broadcast tend. Characters for which there is no standard 
Morse code (such as line feed) are ignored except that the speed Is set by 
characters whose value is greater than 137 to appro itna tely seventy five 
divided iff the difference between the character value and 137 words per atnuto, 
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5, The Procedure 
5*1 Philosophy and Organization 

The use of ITS U entirely procedure oriented. Almost all system actions 
are caused Iwr trapping Instructions [Sec 2*2; App A] executed by user programs 
that are hlerarchially organized [Sec 6*1]* A large number of variables [App 
C; Sec 5,5] are associated with each procedure by the ITS system* These 
variable* are stored in the system and do not Impinge on the user's core Image. 

These procedures are run for short fixed lengths or tiae or until they 
become unrunn&ble (whichever comes sooner) in an order determined by the 
scheduler [5ec 5,4], The scheduler also handles software Interrupts to the 
user [Sec &*Z t 5.4], Vhen in execution, user programs run with the PDP-6 In 
user aode [Sec 2.2*2} which enables protection and relocation hardware that ITS 
sets in acordance with the length [Sec 5.3] and location in absolute leiory of 
the particular procedure's core Image, 

The following are aiong the advantages of this storage of user variables: 



(1) Ho effort by a user's procedure to randomise Its core iaage can effect 
system variables related to the procedure and thus erase evidence of system 
malfunction or lack of malfunction. 

(2) A procedure's core iaage may be easily swapped out without significant 
reduction in information concerning it of interest to the system or the 
necessity to retain some portion of it. 
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5,2 User Interrupts 

ITS provides software implemented interrupts to the user program siiilar 
to the hardware Interrupts It receives. Only one level of interrupt is 
simulated but this makes little difference due to the ease with which the user 

cin inhibit or enable various types of Interrupt [Sec 5.ZA] and may also 

- 

re-enable interrupt* without immediately or ever returning to the location his 
program was Interrupted from. 

Each user has in system memory two interrupt enable mask words, two 
interrupt request words, and a flag indicating interrupt level status [App C] . 
Various coivii lions that can cause Interrupts are assigned bits la these 
interrupt request words. These conditions are divided into three classes 
according to severity. Class one conditions, the most severe, can not be 
enabled, they always cause the "interrupted* program to be stopped and its 
superior procedure to receive an interrupt. Class two conditions are of 
moderate severity. They aay be enabled to interrupt the user but if they occur 
while not enabled or while the user's interrupt level flag indicates he is 
currently process in* an interrupt, he will be stopped and his superior 
procedure interrupted. Class three conditions are the least severe and aay 
also be enabled to interrupt the user* Willi not enabled they have no effect* 
If enabled and they occur while the user's flag indicates he Is free to receive 
interrupts he will be interrupted but if the user's flag indicates he Is not 
free they will be stored In the Interrupt request words to be presented to the 
user as soon as he allows. 

The particular bit used in an immediately superior procedure's second 
interrupt request word to interrupt it when a fatal error occurs in its 
Inferior is the bit assigned by ITS to that Inferior at the tiie it was created 
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[See 6.1,3]* 

When conditions that would cause a procedure's superior to be interrupted 
occur in a top level procedure one of two things may happen. If the procedure 
tops a console controlled tree, a new BACTM will be loaded (as in section 2.1) 
and all Inferior procedures will be lost. If the procedure tops a disowned 
tree [Sec 6.2*2] it will be immediately stopped and when next attached [Sec 
6*1,2] by a Job tree the attaching procedure will be appropriately Interrupted. 

ITS determines that it should actually interrupt a procedure at schedule 
[Sec 5.43 # •DISMISS [Sec 5.2.2], or .UPISEr [Sec 5.2,3] time If there are 
corresponding bits on in one or both of the procedure's interrupt request and 
oask words. ITS examines the contents of the procedure's location 42 to see If 
its direct address (Indexing and Indirect addressing ignored) is between 20 and 
5 less than the top of the user's core image inclusive. If not p the user 
receives a class one Interrupt for a bad location 42. If so, the user's 
appropriate interrupt, word (first vord has higher priority than the second) t 
containins bits on for Interrupts the user is beln? presented with, is placed 
In the word directly addressed by the user's location 42 and bit 4,9 of that 
location is turned on if the second word was stored, the interrupt request 
word stored Is then cleared to receive future Interrupts. The user's Interrupt 
level fla? is also set to inhibit further Interrupts, Finally a JS3 is 
simulated to a location one greater than that la which the interrupts were Just 
stored. The normal Banner to return from an Interrupt is with a .DISMISS [Sec 
5.2,2], 

The following is a list of word one interrupt bits: 



1*2 


1 


1.3 


1 


1.4 


3 


1.5 


z 


1.6 


2 


1.7 


3 


1.9 


1 
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Blt(s) Class Condition 

1*1 3 Character typed at console [Sec 4.5*1]* 
~Z typed [Sec 2.1]. 
Bad location 42. 

IB overflow [8«f U. 

Display List memory protection violation [Sec 4-11]. 

Illegal Instruction. 

System soins down In 5 minutes [Sec 7.5.2], 

.THUS executed [Sec 5,3,1], (Note that a value 
retrieving .35ET is available [Sec 6.2.3] J 

\ m 9 Z Input-output channel error. For more exact cause of 

interrupt use toe .STATUS TOO [Sec 3,5], 

2.1 2 Memory protection violation on reference to inferior 
procedure [Sec 4.12]. 

2.2 1 ,BflEAX executed [Sec 5.3.2]. 

2.3 1 Return fro* single instruction proceed [Sec 7,7], 

2.4 3 Slow clock (every half second), 

2.5 2 Memory protection violation [Ref 1] . 

2.6 2 HAH Interrupt [Sec 7,4], 

2.7 3 light pen [Sec 4,11], 
. 2,3 3 PDl overflow [Ref l] . 

2,9-4,3 - Hot used. 

4.9 - Indicates rest of bits to be interprlted as below. 






In the second word of interrupt requests, bits 3.1-3.8 represent Inferior 
procedures [Sec 6.1.3] and bits 1,1-2,7 represents input-output channels [Sec 
3.1] with 1.1 for channel xero. Interrupts occur from inferior procedures as 
described above for class one or two Interrupts to the Inferiors while an 
input-output channel will try to interrupt If there is buffered teletype [Sec 
4.5] input or character mode core link [Sec 4.3] input on the channel. These 
buffered characters tay te examined at the interrupt level with .ITYIC [Sec 
3.3,3] , 






■ 
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5.2.1 Tha .SETW3K and .S£TH2 UUO's 

These ays tea calls (.0P3H 4 and .OPER 5 re spec tire I jr) provide the 
mechanism by which the user can set his Interrupt enable aask words* These 
mask words contain zero whenever a procedure is created or has a .RESET 
executed on it [Sec 3.3*2, 4.12]. Since the second mask word will not be 
useful to aany sUple program, the first of these calls Is provided to set 
only the first word form the accumulator it specifies, the second will set 
both nasi words from the specified accumulator and the following location. 

A procedure may examine its interrupt masic with the .SU3ST UUO [Sec 5.5]. 
In general a *SUSET will not retrieve what a procedure atteaptes to set in its 
first mask; word as bits UZ 9 1.3, 1.9 t 2.2, and 2,3 (the class one interrupts) 
will not appear set* 

5.2.2 The .DISMISS UUO 

This system call {.GAIL 1,) provides the normal means to return to an 
interrupted routine* It simultaneously re-enables interrupts and transfers to 
the location directly addressed by the contents of Its effective address which 
is normally but not necessarily the pseudo-JSEt word stored by ITS as it 
sliulates an interrupt. If there are pending conditions in the user's 
interrupt request Voris he will be iiaiediately re-interrupted. 









. 
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5.2,3 The .UPISET tftfO 



The user aay arbitrarily Inhibit or enable all Interrupts to his program 
to aeaas of this system call {,OPSR 36) which stores the contents of the 
accumulator specified iato his interrupt level status flag. The zero state 
inhibits Interrupts vhlle the minus oae state enables them. If there are 
pending conditions in the user* 3 interrupt request word when he enables 
interrupt he Mill be interrupted Immediately, The user may eraaine his 
interrupt level flag by means of the .SUSST TOO [Sec 5.5]. 

5,3 The Core Allocator 

An Internal map of the status of erery 2000 word block of memory exists In 
the system and Is maintained by the core allocator. The majority of the 
complexity of the core allocator is not due to aaintaining this table but to 
the actions It must soietltes take to relocate input-output buffers and other 
occupants of core when a procedure wishes to expand* The lack of pageins on 
the PDP-S makes it sometimes necessary to "shuffle* core to make a sufficient 
contiguous block. 

Each 2000 word block oust, except for two transient states, be devoted to 
one of the following usass (1) part of a procedure's core imaje (ITS code and 
variables appear as core allocate! for the systea job [Sec 7,5]), (2) a disk 
buffer or directory [Sec 4.2] p £3) a display buffer [Sec 4,11], (4) unused, or 
(5) further subdivided iato 200 word blocks. These 200 word blocks are used 
for core link device buffers [Sec 4,3] or for DSC tape buffers or directories 
[Sec 4,1], 
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A procedure may request *ore or less core by mean* of the .COSE JUO [Sec 
5.3.1] and determine Its memory bound without nuking protection violations with 
the ,5JS£T iJUO [Sec 5.5]. Other than the .CORE TJO a procedure's memory bound 
•ay be affected only by Us destruction, when all blocks In its core image are 
marked free, or a ,USET [Sec 6.2.3] or .I0T on device USR [Sec 4.12] executed 
by tta immediate superior. 



5,3,1 The .CORE UOO 






This system call (.CALL 6 P ) requests for the procedure executing it as 
many 2000 word blocks as the talus of its effective address except that if this 
value Is zero it will be treated as if it were one. If aad only if the ,C0Rfi 
is successful It skips. Only a .CORE to acquire more core may fail. If it 
does and a sore than one block Increase was betas revues ted , some smaller 
number than requested may hare been obtained. 

5.4 The Scheduler 

The scheduler runs when a quantum time-out occurs or when the physically 
ruaaias procedure encounters a blocking condition or causes an Interrupt by 
soae program action (memory protection violation, PDL overflow, etc). The 
scheduler decides "Which procedure should run next by an examination of the 
variables [App C] in the system for each procedure. It simultaneously performs 
those modifications of these variables necessary to provide the simulated 
interrupt feature [Sec 5.2], 

Tor those procedures that have their stop word [App C] aero, their 
runnabllity Is determined by a variable known as the flush Instruction which Is 
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set when the procedure becomes blocked. If tMs variable is zero the procedure 
is runablep If do a zero it la executed with the procedure's EPDL2 variable [4pp 
C] loaded into ITS symbolic accumulator T. If the Instruction skips then the 
procedure is ruaable and has just tecoae unblocked. If the flush instruction 
does not skip the procedure Is still blocked. 

The next procedure to be run is picked from among the runnable procedures 
by a scan which consider* two "resource" variables per procedure. Both of 
these are quantized approximations to exponential decays toward proportions of 
machine tine. The JTMD variable is associated with a particular procedure 
while the UTHPTR variable pointer for that procedure points to a quantity 
similar to JTMD maintained for all procedures in one console controlled tree. 
During the $c*a to select the next procedure to run, a procedure will be 
prefered to the bast so far if its console tree has used less tine recently 
than that of the best so far or its console tree has used exactly the same 
amount and the procedure has used less tiM recently or its console tree has 
used more but the procedure less than one quarter as such as the best so far. 

All disowned job's OTMPTfi's point to a single word which is given less 
resource than that for a normal console tree. The system Job [Sec 7.5] is also 
given lower than normal priority. 

5.5 Thfi .SUSET UUQ 

Procedures my examine some of their system variables [App C] by means of 
this system call {.CALL 13 J- It Is essentially the same as the ,US£T DUO [Sec 
6.2*3] except that no input-output channel is specified, since it is understood 
to refer to the variables of the procedure executing it. Also variables may 
only be et&ained and tnen only if the 1.3 bit is on in the variables aode 
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6, Procedure Interaction 

6.1 The Hierarchlal Organization of Procedures 

■ 

All procedure* operating under ITS are members of a tree structure 
recorded in the system by associating with each a pointer to Its Immediate 
superior* If this pointer Is minus one it indicates that the procedure tops a 
tree. These trees may be of two types, those under the control of a console 
and those that are disowned [Sec 5*2.2] . 

Console ^controlled* trees have had their top level procedure 
automatically loaded "by ITS [Sec 2.1], Since procedures may control their 
inferiors and the most that the user can do in appealing for aid when 
confronted with recalcitrant programs Is to cause his console to converse with 
higher level procedures [Sec 2,1], he Is actually at the mercy of this top 
level program. It Is currently a DDT expanded by the addition of new commands 
related to time sharing [Ref Z, S, 10] . The only restrictions deliberately 
inserted In it relate to logging In [Sec 7.1], 

Disowned procedure trees differ from console controlled trees only In the 
following ways: (1) they hare no console associated with them; (2) class one 
interrupts in a top level procedure are handled differently [Sec 5.2]; (3) they 
are scheduled with lower priority [Sec 5,4] ; {4) certain system calls [Sec 
4.1,2, 6,1,2, 6,2,^2, 7,S,3. 7,3,4] t when executed in them, are treated as 
illegal instructions. 

There exist a variety of means for procedures immediately above and below 
each other to interact [Sec 5*Z t 5.3]* Procedures may also effect any 
procedure beneath them in the procedure tree by means of input-output 
translation table entries (Sec 3*3] and an arbitrary pair of procedures may 
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converse treating each other as input-output debtees [Sec 4*3] . 

Among the advantages of the above system of procedure orsanliation are the 
following: 



(1) The highest level coauand processor (the top level procedure of a console 
controlled tree) may vary arbitrarily from user to user. In actual operation 
It is normal to see lUCTftN's whose inferior procedure variables and symbol 
tables auch exceed their code* 

(2) Hew versions of the highest level command processor Bay be introduced 
sitply by wrltln? a file on the disk with no interruption to systei continuity, 

(3) New versions of the highest level command processor lay be easily and 
safely debugged by loading thea as inferior procedures. In this position they 
can exercise all their normal functions except logging in and out* 

(4) tt Is not neccessary to make every effort to remove all buss fron the 
highest level command processor for fear that the system may be destroyed by 
them, a consideration often inhibiting sore complex and powerful con&and 
languages. A fatal error simply results in the program being reloaded. 

(5) Users have great generality In creating command levels of their own* 

(6) Multt-tasic prosraas aay be organised in a consistent manner* 



Items 1, 2„ and 4 above argue to various extents against pure procedures as 
does their inherent speed inefficiency. Having to maintain separate copies of 
the highest level coamand processor for each user is not that significant a 
disadvantage if one considers the amount of each copy's core image unique to 
each user and that while not in actual use they could be swapped out of the 
system, 

■ 



■ 
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6.1.1 Procedure Creation 

Procedures may be created only by typing *! on an Idle teletype [Sec 2-1] 
or by executing a .OPEH [Sec 3*2] on device USa [Sac 4.12] . In the second 
case, which 1* discussed here, there are strict requiraents on the "file name* 
used in the .DPES. The first file name, which will be the UMAME of the created 
procedure, oust be the same as the UHAME of the procedure executing the ,OPM, 
The second file name, which will be the JttMi of the created procedure, must be 
different from the JflAHB of all Jobs then in existence that hare the UHAME 
being used. A procedure may hare a maximum of eight directly Inferior 
procedures. A newly created procedure will have one 2000 word block of cleared 
aeaory and all of Its systea variables Initialized, some as follows; its 
interrupt saak words will be zero and its interrupt level status word will be 
ainus one [Sec 5*2]; its system naae [Sec 3.8*4] will be set to its UUAHE; Us 
prograa counter (PC) will be set to zero; Its stop word [App C] will have the 
user control bit oa« 

6.1.2 Attaching Disowned Procedure Trees 






The only case in which a successful .OP&t [Sec 3.2] on device USR [Sec 
4,12] »ay be executed to provide an inferior procedure (as opposed to opening a 
procedure for examination only) with a first file name different from the UKAME 

of the procedure executing the OPSH Is that is which the top procedure of a 

■ 

disowned tree is being opened, this type of -OPEN will be treated as an 
illegal instruction if executed by a procedure in a disowned tree. If not ITS 
chectee only to see that the UtAME of the opening procedure and the JHAHE of the 
procedure being opened will forx a unique pair, If so and the opening 
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procedure baa loss than eight Inferiors the open will succeed and ITS will 
aodlfy the URAHE of the opened procedure to agree with the opening: procedure. 
The BKAME's of procedures. If any, deeper In the attached tree are not 
modified . 

6.1.3 The .&TRAH tfUO 



When a procedure Is first created "by a .OPEN, ITS assigns to It a bit for 
use la Interrupts [Sec 5.2] to Its superior procedure different from that for 
any other inferior procedure its superior may have. Since Inferior procedures 
can only be directly controlled when open on input-output channels, the loss of 
the naaa of an inferior by its superior while It was not open would result in 
complete loss of communication. Although procedures that hare inferiors 
noraally iceep close track of their names and interrupt bits as read by iUSBT's 
[Sec 6.2.3] p this system call (.CALL 5,) has been provided to translate froa 
particular interrupt bit to name of inferior. The left half of of the contents 
of the effective address aust have only the appropriate interrupt bit on. If a 
corresponding Inferior procedure Is found, the .DTRAK sfcips arvi the OUAWE and 
JKAWE of the inferior are stored in the two words after the word containing the 
interrupt bit. If no corresponding Inferior is found the •TTPRAJi will fail to 
sicip and the two locations after the location it effectively addresses will be 
unmodified. 



• 
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5*2 Control* over an Immediately Inferior Procedure 



See also section 4,5.1* 

6*2*1 The *UCL0SE UUO 

Procedures say be destroyed only by the execution on a «£0909T [Sec 7.1] 
or a ,XLOSE. The second of these two system calls (.0P£R 10) # which is 
discussed here, destroys the Inferior procedure open on the channel specified 
by Its accuaulator field and the entire procedure subtree of which this 
inferior Is the top procedure, .Close's [Sec 3.7,1] are automatically effected 
on all channels of all the destroyed procedures and if any one of the-a is 
running the B2C 340 display [Sec 4.11] a .DCL05E will be executed for It. In 
order to kill certain cancerous types of procedure subtrees It has been found 
necessary to so implement this systen call such that It first stops all 
procedures in the subtree and then destroys them. 

6*2*2 The .DISOW UtfO 

This system call ( f QPEl 27) reiuires that an Inferior procedure be open on 
the channel specified by Its accuiulator field. It causes this open procedure 
to hecoae the top "procedure of a disowned tree and in the process closes all 
channels on which the disowning procedure has it open. A procedure In a 
disowned tree that tries to execute this system call will be unsuccessful and 
receive an Illegal instruction interrupt [Sec 5,2] as will a procedure trying 
to disown a subtree that controls the tree's console [Sec 4,5,1]* 
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6,2,3 The ,US£T 030 



In order to allow a procedure to set and read aany of the system variables 
[App C] associated with Its Inferiors, this system call was created. ¥hen 
executed its accumulator field lust contain the number of a channel on which an 
inferior procedure Is open* The contents of its effective address Is viewed as 
two half words with the right half pointing to the location from which the 
system variable is to be set or into which the system variable Is to be read. 
The left half specifies by its top bit (4.9) whether the system variable Is to 
be read (zero) or written {one) and by the value of its remaining bits which 
system variable. The following table lists permissible values s 



Sue 


Value 


Typ« 


"J?3 





7 


VALUE 


1 


7 


.VAL'JS [Soc 


6.3,1], 




m 


2 


1 


PLSIS3 


3 


1 


(TRAMS 


4 


5 


JHA1S 


5 


7 


MASK 


6 


7 


USTP 


7 


3 


PlffiJC 


10 


7 


ISTB 


11 


1 


MKM'P 


12 


7 


Illegal to i 


•efartace. 


ST40 


13 


5 


IPIRQ 


14 


7 


APIRQ 


15 


7 


SSiKi 


15 


7 


PICLH 


17 . 


7 


HAEA 


20 


7 


HAflPC 


21 


7 


TOOH 


22 


5 


mm 


23 


1 


RONT 


24 


5 


HSX2 


25 


7 


IFPIR 


26 


7 




27-77 









Variable 

Pro-sras counter word. 

Contents of effective address of nost recent 

Status relative to console [Sec 4.5]* 

Blocking condition [Sec 5.4] , 

[MAKE [Sec 4.12], 

JWAHB [Sec 4.12]. 

Interrupt iHk word [Sec 5,2]. 

Stop word (only Mt 4.7 can be written). 

Interrupt request word [Sec 5.2]. 

Bit used to interrupt superior [Sec 6*1,3]. 

Memory bound [Sec 5,3] , first location it would be 

Last executed TJO trapping to system* 

Interrupt request word (written by m IOIBO. 

Interrupt request word (written by an AKDCAN). 

Systea name [Sec 3.7*4]* 

Interrupt level status word [Sec 5.2]* 

MAJt register and control bits [Sec 7.4.2], 

Program counter at last HAH Interrupt [Sec 7,4*1]* 

Progr&i counter word at last systei 1JUD. 

User index. 

Total run time In 4*063 microsecond units* 

Interrupt ftastc word two [Sec 5.2]* 

Interrupt request word two [Hef 5.2], 

Unused. 
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IOC 


1Q0+X 


1 


103 


12041 


1 


iop 


143+S 


1 



Input-output channel word for channel fl. 

Status word for Input-output channel N* 

nth word of input-output channel push do*u list* 



In the "type" column above „ bit 1*1 on indicates that the variable iay "be real, 

bit 1,2 that it iay be written, and bit 1.3 that It may be read with as .S'JSET 
[Sec 5*5]* 

6*3 Coauvinication to an Immediately Superior Procedure 

6*3*1 The .TAWS OtTO 

A procedure executing this systei call (.CALL 4,) receives a class one 
interrupt [Sec 5*2] stopping it and interrupting Its superior procedure* The 
contents of the effective address is saved in a system variable associated with 
the procedure [App C] so its superior can easily retreive it with a .USET [Sec 
6.2*3] * 



S,3,2 The .BREAK UUO 



The accumulator field and effective address of this UUo are ignored by 
ITS. A procedure executing it receives a class one interrupt [Sec 5*2] 

stopping it and interrupting its superior procedure* 



. 
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7* Miscellaneous System Calls and Features 
7.1 The ♦LOGIS and .LOSOOT UUO's 

These two systea calls (*QP2R 6 and »OP£R 33) are the only ones that are 
effective at only the top level, 

.LOGQtfT has no effect and simply returns fron the system to the 
Instruction following If not executed In a top level procedure. It causes the 
procedure tree In whose top procedure It is executed in to he expunged from the 
5/s to*. It works for both console controlled trees and disowned trees. Since 
the nonaal means to create [See 6.1,1] and destroy [Sec 6,2,1] a procedure 
under ITS are calls In a superior procedure, the special case of the top level 
procedure must he bandied differently as it is by ~l [Sec 2,1] and ,LC£Q f JT. 

•LOSlH is not restricted to top level procedures by ITS hut rather by 
HAG Tan, the top level procedure ITS automatically loads [Sec 2,1], A .LOJ1K 
represents an attempt by a procedure to set Its tlHAMS to the contents of the 
accumultor specified. This Is allowed by ITS only tf the procedure's current 
UHArfE Is minus one {as the HHAHiS of Initial KACTRK's Is set) and the desired 
UNAMS is neither zero nor minus one, The success of a .LQ&IH Is signalled by 
its shipping. HACTR* will not open Inferior procedures for a user until he has 
successfully lodged In at which point his inferior procedures rflll have flSAMI's 
doomias future .lobll't In that tree to failure. 



- 
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7.2 Jtonsteniard Daviess 



7,3.1 The .3DS¥ CTLTO 



This systea call (.QPlEt 20) reads (DATil's [Ref 1]) the contents of the 
data switches on the PBP-6's console Into the specific accuaul&tor. 

7.2,2 The .RD7S0 and .¥3730 MO* 3 

These systea calls (.OPUS 30 and .OFSK 31) respectWely re*! the control 
register (COSI) of the device whose POP-5 device neater Is 730 Into the 
specified accumulator and output (C3HD) all bat the bottom three hits from the 
specified accumulator to the control register of the device [Ref 1], The Mta 
In the control register of this device ars usually used for temporary direct 
control or sense hookups* 

7.2*3 The .RD710 UtfO 

The real tiae cloche which ITS currently uses to tiae user *uantuas has, as 
*ell as an Interval tiling counter, a clock counter which Is neither sat or 
stopped by ITS. This systea call (,0PEa 47) reads into the specified 
accumulator a wor* whole bottoa twenty four bits are this clock counter.. It Is 
incremented once etery 4,069 microsecond*. 

■ 
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7,2.4 The .ORGI and .OftGO CTJO's 

These system calls (.OPES 54 and .OFBR 55) Input or output fro* their 
specf ifled accumulator and the two following locations from and to what will be 
an electric organ keyboard and tone generators. 



7.3 Various Tines and the Date 



7.3,1 The ,HDTIME [TOO 



This sytea call (,QPER 17) reads into tlie specified accumulator the 
Internal system tin which is a word set to aero when a system Is first loaded 
and 1$ incremented e?ery thirtieth of a second thereafter. 



7.3.2 The ,*TIHE WJQ 

After the system has determined real (24 hour system) time, it maintains 
this internally as a nuaber in units of one half second since the last 
midnight. This system call (.0P2R 45} reads into the specified accumulator In 
siibit characters this time in pairs of digits reading from the left hours, 
minutes, and seconds* If the time has not yet been determined, minus one will 
be read. 



■ 
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7,3,3 The .SDATE TOO 

After the system has determined the calendar date, it sain tains It 
Internally as a word with six sixblt characters In it* These characters are 
all numeric. The first two are the last Wo digits of the year, the next two 
are the month number f and the last two digits are the day of the month* This 
system call (.OPKft 46) reads this word into the specified accumulator* If the 
date has not yet been determined minus one will he real. In the current 
implementation, the date being determined implies that the time [Sec 7.3.2] has 
been determined. The date is correctly incremented etery aldnisht. 



7.4 The MAS feature 



In order to simulate the address stop facility of the PDP-S in a time 
shared mode, it was decided to Introduce a new hardware register, the HAS 
register t to cause interrupts when a particular location was addressed by the 
computer. To increase the flexibility of this feature, three control bits were 
added which further define the interrupt condition given that a memory address 
match has occured. 

Aaong the system T&riables kept by ITS for each procedure are its MAR 
register contents and control bits. These are loaded into the hardware as the 
user Is started. *Slnce the MAR feature is intended primarily as a debugging 
aid, it causes a class two interrupt [Sec 5.2] and the .tfSBT*s [Sec 6.2.3] 
corresponding to the following UOO is used »ore frequently than it is. 

When an MAR interrupt occurs, further MAR interrupts are disabled until 
the HAR is again set. 
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7.4.1 the .WAR ITUO 



This system call (,OPSR 41} takes the right half of the specified 
accumulator as the new address to be put in ths MAS register and the low three 
bits of the left half as conrol bits as follows: 



Bit Meaning {one state) 

3.3 Interrupt If data read or written is negative. 

3,2 Interrupt if data read or written is positive. 

3.1 Interrupt only on a write. 



At this tine, attempts to differentiate read cycles on the basis of sign vill 
fail as t due to a timing error, the data always appears positive, 

A .SUSBP [Sec 5,5] may be used to read the word stored by the JSR at the 
system's processor Interrupt channel location when the last MAS interrupt 
occured. Although, for their own safety, some parts of executive code inhibit 
MAE interrupts, it is suite possible for the user to cause soae system calls to 
Interrupt to the user, on reference to his core image where his HAS is 
pointing. The prograi counter word stored by the JSS at the user's location 42 
[Sec 5,2} will be the location in his core image of the offending system call. 
The word read by a .StfSEt will be an executive program counter word showing the 
absolute location at which the system call attempted to reference the user's 
core image. 
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7.5 The Systea Job 

There are various tasfcg ITS would like to perform, lost of which Include 
input-output, which would "be inconvenient to implement directly due to the 
procedure originated orientation of almost all system rountlnes. Because of 
this a procedure was synthesized that is actually a part of the monitor and 
always runs In executive mode. Known as the system Job, it is scheduled [Sec 
5.43 with lower priority than other procedures P To aid in debugging ITS a 
feature was added to the system Job so that when it had no other tasks to 
perform it would compare constant parts of ITS against a copy It makes 
Initially [Sec 7*5,1], The following are some of the tasks the system Job 
performs; 



... 

(1) Does .CQRE's [Sec S.3*l] for ITS to aaice room for more blocks of user 
far tables or for the system Job's copy of constant parts of ITS, 

(2) Prints messages on the system console whenever an effective # SETL0C [Sec 
7.8.4], .IOTLSR [Sec 3.3.3], or .OPEK [Sec 3,2} on device STS [Sec 4,2] for 
output is executed. 

(3) Prints messages on the system console when a parity error, uareiuested 
change in teletype priority interrupt channel allocation memory excessively 
full condition, login p or logout occurs, 

(4) Initially determines the 24 hour time and calendar date [Sec 7,3.2, 7,3.3]* 

(5) Prints a messa?e on all teletypes when the system is first loaded. 

(5) Outputs a *CO5lS0Ui FREE" message on any teletype when it is no longer open 
ty any procedure. " 

(7) Tarlous tasks related to the sytem going down feature explained in section 
7*5.2 below. 
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7*5*1 The .SUPSET UUO 

The system job la partially controlled by ITS through a word In 
systea memory. Bits In the left half of this word represent requests for some 
transient action. In the right half only the bottom "bit (l.i) 1* currently 
used and controls the systea checking feature. If this bit U on, the system 
Job radices a copy of the constant parts of ITS and precedes to spend its spare 
time cheeking the areas it copied against the copy. If a discrepancy occur*, a 
aessage Is printed and the copy corrected. If this bit is off p the system Job 
Mill destroy any copy it may hare, freeing that memory and aost of the fraction 
of the machine time the systea Job ases when In checking mode. 

The ,SUPSET system call {.GPER 53) enables the user to control the system 
checking bit by lOR'in^ the contents of the rl«ht half of the specified 
accumulator with the system Job control word and returning the resulting value 
in the specified accumulator. 

7.5.3 The Systea Going Itown Feature 

To provide an orderly means for the termination of the operation of ITS, a 
special feature has been added. It is activated by setting absolute location 
37 negative (either with the PDP-6 console keys [Kef 1] or a ,SETU)C [Sec 
7,3.4]), After tfils is first noticed, all procedures for which it is enabled 
will receive a system going down interrupt [Sec 5*2] and all free teletypes 
hate an appropriate message typed on them. At this tiae a five minute timer Is 
started and further ~Z*s on idle teletypes ignored [Sec 2,1]* At the end of 
the five minute period or when the number of console controlled trees in which 
successful .LOGICS [Sec 7.1] have "been executed soes to zero, all trees are 
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forcea&ly logged out and a message typed on all teletypes. Then a prograa is 
loaded from device SYS and started such that if the address switches on the 
PDP-6 console are set to zero and the amplifier and loudspeakers attached to 
the low order bits of the nemory Indicator turned on, a rendition of the United 
States national anthem will he heard. 

7,3 Bsuiatag ITS 

7.5.1 The .GETSTS UUO 

This sytem call (.OPER 23) enables a procedure to receive copies of 

various Internal monitor areas in such a way that the data In those areas oust 

be consistent* The specified accumulator contains a pointer word as for a 

• 
block aode ,IQT [Sec 3*4]* The location following the specified accumulator 

contains, in left justified sixbit, the area requested as follows: 



Siihit Area 

TRASS Translation table [Sec 3.3]* 

SETS List of things vhich can be requested with ♦GETSTS. 

DBTS List of available syahloic input-output devices [App B] P 

MEMOS! Memory allocation tables [Sec 5.3]. 

UTAPE DEC tape routine variables [Sec 4*1], 

DDISS Disk routine variables [Sec 4,2], 

n CiMI Core link Tarlables [Sec 4*3]* 

CALLS List of symbols in squoae for system calls [App A] and *U3£T [Sec 
5.2*3] left halves and their values* 

DSTHS S/abol table for ITS. 

IHPX Area Input multiplexor cycled into [Sec 4*9]. 

OHPI Area output multiplexor cycled from [Sec 4.10]. 

CJSER3 User variables for all procedures. 

USER User variables for particular user specified by USAME and JKAKE 
in locations t*o and three greater than the specified aecuaulator [App C] . If 
user not found location containing UHAMB will be seroel* 



Interrupts are inhibited to a sufficient extent that the data obtained can not 
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.- 

be Inconsistent due to the areas notification while beins transfered to the 
user. A. successful JSSSSHS will slclp. One that fails, due to non-recognition 
of Its sixblt word or insufficient memory specified by its pointer word, will 
not skip and In the former case the s libit word will be xeroed. 

7.9.2 The .GETLOC u"JO 

■ 

This system call (.OPSa 25) simply transfers the contents of the absolute 
location pointer to by the left half of the specfied accumulator to the user's 
relative location pointed to by the risht half. If the right half points 
beyond the users memory bound he will receive an illegal instruction interrupt 
[Sec 5.2] . 

7.6.3 The .R3TSI B30 



This sytem call (.0P2R 52) reads into the specified accu.mila.tor the sixbit 
representation of the second file name of the symbolic file that was assembled ^ 
to produce th* running version of ITS. 



• 



7.7 The One Proceed Feature 

The Project KAC II Group PDP-6 has been modified so that there exists a 
■ode In which It executes one Instruction and then traps. This mode is 
properly stored when an interrupt occurs and Is restored by JRST 2 f [Ref 1] . 
For users it causes a class one interrupt and Is expected to be used by 
guperior procedures by .USET'ins [Sec 6.2.3] the 3.9 bit of their inferior's 
program counter word. There is coding in ITS such that ail systea calls will 
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■ 



appear to tie single instructions using this mode. Vhile in this mode a user 
Interrupt may be serviced and the users status, including this »ode r will be 
restored hy a noraal .DISMISS [Sec 5.2,2]. 

7.9 Miscellaneous 
7.3.1 The .SW2P MO 






. .. 



This system call (.OPE3 3) allows a procedure to atop rumnias P while 
reaainiag in terrup table, by either specifying ft length of tlae to reaaia 
auescent or a particular time to waite up. If the specified accumulator 
contains a positive nuaber it L« considered the leneth of time, la thirtieths 
of a second, that the procedure wishes to sleep. If the specified accumulator 
contalas a negative number then the procedure will sleep until the magnitude of 
systen tile (as read by .5DTIME [Sec 7.3,1]) is srsater than the aa&iitudft of 
this aesatlte number. When a .SLEEP returns, the accumulator specified will be 
tarQg but If a program Is interrupted oat of either type of .SLEEP the 
accutulator will be seen to contain the appropriate negative number. 



7.8,2 The .{JESSYM JUQ 






This system (fall {.OPSR 32) returns in the specified accumulator a valid 
siiblt flle-name-llke sy.hol that will be unique among those returned by 
.GEKSYM's for a particular system. 



■ 
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7.8.3 The .IOTLSR WO 

Procedures run by ITS In IQT-user mole may eiecute hardware Input-output 
instructions which would otherwise by Ineffective and trap to the monitor. 
This systet call (,0P5R 31) sat the IOT-user status of the procedure executing 
tt froa the sign "bit of the specified accumulator. If this bit is a one and 
the procedure is not currently in IQT-user mode it will enter it and a aeasage 
will l>e output by the systea Job [Sec 7*5] unless the procedure is In a 
disowned tree la which case it ¥111 receive an illegal instruction interrupt 
[Sec 5*2] , 



7*8,4 The ♦SSTLOC UUO 






■ 



This system call (,OPSR 25} treats the specified accumulator as two half 
word pointers, tt takes the contents of the relative user location pointed to 
W the left half and places it In the absolute location pointed to by the right 
half and causes the systea job to output an appropriate aessa?* [Sec 7,5] 
unless the procedure executing it Is In a disowned tree In which case the 
procedure will recelre an illegal instruction interrupt [Sec 5.2], 
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Appendix 

A. Systai Calls La tfumerlc Ord*r 

tcomct as of ITS version 330) 



liL.ti* 


Rubber 


Section 


JOT 


ouo 043 


3.4 


.OPEN 


UUO 041 


3.2 


.OPER 


DUO 042 


2.2.1 


.LISTEN 


,0PSR 2 


4.5.2 


.SLEEP 


.oper 3 


7.3J 


.SETMSK 


.OPSR 4 


5,2,1 


.SETH2 


.OPSR 3 


5,2,1 


.LOS IS 


.OPER 5 


7.1 


.CLOSE 


jamt 7 


3.7.1 


.UCLOSS 


.opea to 


6.2,1 


.MTY 


.oper ii 


4,5.1 


.DTTT 


.OPER 12 


4.5.1 


jopush 


.OPER 13 


3,7.2 


JOPOP" 


.OPffi 14 


3,7,2 


.DOLOSE 


.OPER 15 


4,11.3 


.DSTOP 


.OPER 15 


4.11,4 


♦RDHME 


.OPER 17 


7.3.1 


.RDS* 


.OPSR 20 


7.2,1 


.'JDISHT 


.OPSR 22 


4.1.1 


.GETSTS 


.OPSR 23 


7.6.1 


.OSTLOC 


.OPEft 25 


7.6.2 


.SfiTLOC 


.OPER 26 


7,9.4 


JUSOWX 


.OPER 27 


6.2,2 


.RD7S0 


,oraa so 


7.2.2 


.WR760 


.opea 3i 


7.2.2 


.3ESSY:4 


.opsr 32 


7.3.2 


.LOGOUT 


.OPER 33 


7.1 


.WSNAMS 


.OPER 35 


3,9,4 


.OPISET 


.OPSR 36 


5.2.3 


.RESET 


.OPER 37 


3.7.3 


.WMAR 


.OPER 41 


7.4,2 


.Assiait 


.OPER 43 


4.1.2 


JJBSISTI 


.OPER 44 


4.1.2 


.RTIMS 


.OPSR 45 


7.3.2 


.RDATE 


.OPSR 4-5 


7.3.3 


.Wtfio 


.OPfJR 47 


7.2.3 


.EOFC 


.OPER" 50 


3.4.1 


JOTLSH 


.OPER 51 


7.8.3 


.RSTSI 


.OPER 52 


7.6.3 


.SIJPSET 


.OPER 53 


7.5.1 


.OR3-0 


.OPSR 54 


7,2,4 


,0911 


.OPBR 55 


7,2,4 


.tJBUT 


.OPER 56 


4.1.3 


JOPDL 


.OPSR 57 


3.7.2 


JTTIC 


.OPER SO 


3.9.3 


.MASTER 


.OPSR 61 


App D 


.Din 


.OPSR 63 


App D 



. 



i 
ITS 1.4 Reference :4aaual P*«* 75 



.DIALW 


.QPER 64 


App D 


.HAHC3P 


.OFB3 65 


App D 


♦CALL 


UUO 043 


2.2.1 


.DtSHlS 


.CALL 1, 


5.2.2 


♦TRASS 


.CALL 2, 


3.3.1 


.TRARAD 


.CALL 3, 


3.3.2 


.TALOE 


.CALL 4, 


6.3.1 


.UTRAS 


.CALL 5, 


6.1.1 


.CORE 


.CALL 5, 


5.3.1 


.TRAHDL 


.CALL 7, 


3.3.3 


.DSTAftT 


.CALL 10, 


4.11.1 


.FDSLE 


.CALL 11, 


3.5 


.OSTRTL 


.CALL 12, 


4,11.1 


.3US2T 


.CALL 13, 


5.b 


.LTPia 


.CALL H. 


4.11.2 


,US£T 


[TOO 044 


6.2.3 


.BREAK 


DUO 046 


6.3.2 


.STATUS WO 046 


3.6 


.ACCESS 


DUO 047 


3.3.5 
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Appendix 

B. Available Symbolic Devices in Alphabetic Owltr 

(correct &s of ITS version 350) 



Device 
CLQ 

GLU 
COD 
COM 
DDn 
DIS 
IDS 
IMX 
LPT 
3UL 
HPfD 
OMX 
PLT 
PTP 
PTR 
SYS 

TTT 
USR 
UTn 

7ID 



Other references 
[Sec 3.2.1, 3.3,4] 
fSec 3.2,1. 3.3.4] 
[Sec 3.4] 
[Sec 3.2,1] 

3.2.1, 3.4.2, 3.8,4] 

1] 



[Sec 
[Ref 



[Sec 3.1. 3,4; Ref 5,5] 
[Sec 3.4J 



[Sec 3.1, 3.4] 

Ref 5, 5] 

.Sec 3.4; Sef 9] 

Sec 3.4j Sef 1] 

[Sec 3.4; Ref 1] 

[Sec 3.2.1, 3,4.2] 

Sac 2,1, 3.4; Ref 

Sec 2.1, 3.4; Ref 



1:3 



[Sec 3*3,5, 5*3] (aost subsections of section Q) 
Sec 3.2.1. 3,4,2; Sef <l] 
3.1, 3*4] 



r Sec 















. 
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Appendix 

C. Sjrstea Variables per User 

(correct as of ITS version 3SG) 



lOCHUHt 
alOCHJiJ 
iluCP: 
UPC; 
ACQS; 
ACiSSi 
AC16S; 
AC17SI 
UUO; 
SUEllTi 
SUUOH: 
SACiTPl 
AC 14?: 
AClbPi 
AC16PJ 

40P! 

41P; 
UP*: 
APEC; 

UQUAMi 
V&Wi 

PIfiftC: 
SUPPBO: 
PICLR; 
MSiST: 
FLSIESi 
MiM'iOPs 
atfiHT; 
ST40t 
UKAHE; 
JXAM£; 
TTYTBL; 
VAJJE: 
UMSOth 
USTSIMs 
USYSXli 
IOCHST : 
UTRfeTM; 
UTRPTR: 
JTHtli 
lOTLSft: 



UMAflPC: 
RUPR: 

UFIEAL; 

IFPIRt 



BLOCK 20 ; input-output channel words 

SLOCK LUXQP ; input-output channel push down list 

SIOCEU-1 j pointer into input-output pusn down list 

;stores program counter wnen not running 

SLOCK 15 ;swap out accumulators 

jcoMoai/ referenced swap out accumulator 

I . 



JEST 2,Wft0a juaer UUO exit Instruction 

{contents of 841 (absolute) 

MOVEH U, {accumulator 1? In user's snadow memory 











APRCHJi 
















-1 




BLOCK 

















5 points,, to accumulator 14 in shadow memory 
i lti 

l lb 

;pgigt^ Jo w user s relative location 40 

} 41 

; protection and relocation registers 

jcono to processor 

;4.9 implies user in pUCLGSS 

; quantum time 

;stop word ;zero iaplies ruan&ble 

spending Interrupts 

{pointer end interrupt bit to superior procedure 

^interrupt level status flag 

; Interrupt enable &as£ 

I blocking condition Instruction 

?»ix leas than first illegal location 

; first illegal location 

{last interrupting UUO 

juaer naae 

{job n&ue 

; console assignment for this procedure 

; contents of effective address of last ,VALU£ 

;zero iaplies top procedure of a dlsovned tree 

; current ays tea naw 
{system name used inside dlslc routines 
20 {input-output channel status words 
{total run time 

{pointer to procedure tree resource word 
{procedure resource word 
;4*9 a one implies iot-user aode * 
;4.5-4.3 KAR conditions 
ii. 9-1.1 contents of MAR register 
} program counter at last MAR interrupt 
{protection and relocation registers actually used 

{nonzero Implies flnalization required to interrupt 

{second word of interupt requests 
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■ 






J4SKST2: ; second word interrupt enable oast 

IKRpDLi -LCTPDL. f UPDL-l ;push down list pointer for system calls 

JpDLs BLOCK LOPDL-2 jpush down list area for system calls 

EPDL: j temporarily saves accumulator E for ACOM 

EPDL2; jteaporarlly saves accumulator f for FLSISS 






- 



. 



■ 









■ 



■ 
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Appendix 

D. Further Sources of Information on ITS 

Infon&tion further than or aore recent than that contained in this manual 
■ay usually be obtained by consulting the systolic listings of ITS. The 
following persons oay also be helpful: 






Donald E. Eastla&e 111 
Richard D* Greeablatt 
Thoaas ?* Knight 
John T* Hollo nay 
Stewart B» Nelson 

... 









- ■ 



- 



. 



